Yandex Cloud Marketplace License Manager for SaaS, gRPC: InstanceService.Get

Статья создана

Yandex Cloud

Обновлена 8 августа 2025 г.

gRPC request
GetInstanceRequest
licensemanager.v1.Instance
Lock
ExternalInstance
ExternalSubscription
ExternalLicense
Template

Returns the specified subscription instance.

gRPC request

rpc Get (GetInstanceRequest) returns (licensemanager.v1.Instance)

GetInstanceRequest

{
  "instance_id": "string"
}

Field

Description

instance_id

string

Required field. ID of the subscription instance.

licensemanager.v1.Instance

{
  "id": "string",
  "cloud_id": "string",
  "folder_id": "string",
  "template_id": "string",
  "template_version_id": "string",
  "description": "string",
  "start_time": "google.protobuf.Timestamp",
  "end_time": "google.protobuf.Timestamp",
  "created_at": "google.protobuf.Timestamp",
  "updated_at": "google.protobuf.Timestamp",
  "state": "State",
  "locks": [
    {
      "id": "string",
      "instance_id": "string",
      "resource_id": "string",
      "start_time": "google.protobuf.Timestamp",
      "end_time": "google.protobuf.Timestamp",
      "created_at": "google.protobuf.Timestamp",
      "updated_at": "google.protobuf.Timestamp",
      "state": "State",
      "template_id": "string",
      "external_instance": {
        "name": "string",
        "properties": "map<string, string>",
        // Includes only one of the fields `subscription`, `license`
        "subscription": {
          "subscription_id": "string",
          "license_id": "string",
          "activation_key": "string"
        },
        "license": {
          "license_id": "string",
          "payload": "bytes"
        }
        // end of the list of possible fields
      }
    }
  ],
  "license_template": {
    "id": "string",
    "version_id": "string",
    "name": "string",
    "publisher_id": "string",
    "product_id": "string",
    "tariff_id": "string",
    "license_sku_id": "string",
    "period": "string",
    "created_at": "google.protobuf.Timestamp",
    "updated_at": "google.protobuf.Timestamp",
    "state": "State"
  },
  "external_instance": {
    "name": "string",
    "properties": "map<string, string>",
    // Includes only one of the fields `subscription`, `license`
    "subscription": {
      "subscription_id": "string",
      "license_id": "string",
      "activation_key": "string"
    },
    "license": {
      "license_id": "string",
      "payload": "bytes"
    }
    // end of the list of possible fields
  }
}

Field	Description
id	string ID of the subscription instance.
cloud_id	string ID of the cloud that the subscription instance belongs to.
folder_id	string ID of the folder that the subscription instance belongs to.
template_id	string ID of the subscription template that was used to create subscription instance.
template_version_id	string ID of the version of subscription template.
description	string Description of the subscription instance.
start_time	google.protobuf.Timestamp Timestamp of the start of the subscription.
end_time	google.protobuf.Timestamp Timestamp of the end of the subscription.
created_at	google.protobuf.Timestamp Creation timestamp.
updated_at	google.protobuf.Timestamp Update timestamp.
state	enum State Subscription state. `STATE_UNSPECIFIED` `PENDING`: Subscription created but not active yet. `ACTIVE`: Subscription is active. `CANCELLED`: Subscription canceled. It is still active, but won't be automatically renewed after the end of the current period. `EXPIRED`: Subscription expired. `DEPRECATED`: Subscription deprecated. `DELETED`: Subscription deleted.
locks[]	Lock List of subscription locks.
license_template	Template Subscription template.
external_instance	ExternalInstance External subscription instance (optional).

Lock

Field	Description
id	string ID of the subscription lock.
instance_id	string ID of the subscription instance.
resource_id	string ID of the resource.
start_time	google.protobuf.Timestamp Timestamp of the start of the subscription lock.
end_time	google.protobuf.Timestamp Timestamp of the end of the subscription lock.
created_at	google.protobuf.Timestamp Creation timestamp.
updated_at	google.protobuf.Timestamp Update timestamp.
state	enum State Subscription lock state. `STATE_UNSPECIFIED` `UNLOCKED`: Subscription unlocked. `LOCKED`: Subscription locked to the resource. `DELETED`: Subscription lock deleted.
template_id	string ID of the subscription template.
external_instance	ExternalInstance External subscription instance (optional), for usage convenience propagated from parent subscription instance.

ExternalInstance

ExternalInstance attachment to external service subscription.

Field	Description
name	string Optional external subscription name.
properties	object (map<string, string>) Mapping of vendor defined properties in key, value format.
subscription	ExternalSubscription Includes only one of the fields `subscription`, `license`.
license	ExternalLicense Includes only one of the fields `subscription`, `license`.

ExternalSubscription

Field	Description
subscription_id	string External subscription id.
license_id	string Optional: paired license id for external subscription.
activation_key	string Optional: default activation key for external subscription.

ExternalLicense

Field

Description

license_id

string

External license bound to subscription instance.

payload

bytes

License (vendor specific) payload.

Template

Field	Description
id	string ID of the subscription template.
version_id	string Version of the subscription template.
name	string Name of the subscription template.
publisher_id	string ID of publisher.
product_id	string ID of product.
tariff_id	string ID of tariff.
license_sku_id	string ID of subscription SKU.
period	string Subscription period.
created_at	google.protobuf.Timestamp Creation timestamp.
updated_at	google.protobuf.Timestamp Update timestamp.
state	enum State Subscription template state. `STATE_UNSPECIFIED` `PENDING`: Subscription template created but not active yet. `ACTIVE`: Subscription template is active. `DEPRECATED`: Subscription template deprecated. `DELETED`: Subscription template deleted.

Yandex Cloud Marketplace License Manager for SaaS, gRPC: InstanceService.Get

gRPC requestgRPC request

GetInstanceRequestGetInstanceRequest

licensemanager.v1.Instancelicensemanager.v1.Instance

LockLock

ExternalInstanceExternalInstance

ExternalSubscriptionExternalSubscription

ExternalLicenseExternalLicense

TemplateTemplate

Была ли статья полезна?