Todos os produtos
Search
Central de documentação

Key Management Service:GetKmsInstance

Última atualização: Jun 28, 2026

Obtém os detalhes de uma instância KMS.

Descrição da operação

Consulte Resource Access Management para a política de acesso necessária para chamar esta OpenAPI como um usuário RAM ou função RAM.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

KmsInstanceId

string

Sim

O ID da instância KMS a ser consultada.

kst-bjj62f5ba3dnpb6v8****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os detalhes da instância KMS.

RequestId

string

O ID da solicitação. O Alibaba Cloud gera um identificador exclusivo para cada solicitação. Você pode usar este ID para localizar e solucionar problemas.

46b4a94a-57d2-44b4-9810-1e87d31abb33

KmsInstance

object

Os detalhes da instância KMS.

3

InstanceId

string

O ID da instância KMS.

kst-bjj62f5ba3dnpb6v8****

InstanceName

string

O nome da instância KMS.

kst-bjj62f5ba3dnpb6v8****

Status

string

O status da instância KMS. Valores válidos:

  • Uninitialized: A instância não está ativada.

  • Connecting: A instância está conectando.

  • Connected: A instância está ativada.

  • Disconnected: A instância está desconectada.

  • Error: A instância está em estado de erro.

Connected

CreateTime

string

A hora de criação da instância KMS.

2023-09-05T12:44:20Z

Spec

integer

O desempenho computacional da instância KMS.

1000

KeyNum

integer

O número máximo de chaves que podem ser criadas na instância KMS.

1000

SecretNum

string

O número máximo de credenciais que podem ser criadas na instância KMS.

10

VpcNum

integer

O número máximo de VPCs que podem ser associadas à instância KMS para controle de acesso.

5

VpcId

string

A VPC à qual a instância KMS está vinculada.

vpc-bp19z7cwmltad5dff****

ZoneIds

array

As zonas às quais a instância KMS está vinculada.

"cn-hangzhou-k", "cn-hangzhou-j"

string

VswitchIds

array

Os vSwitches na VPC à qual a instância KMS está vinculada.

vsw-bp1i512amda6d10a0****

string

EndDate

string

O tempo de expiração da instância KMS.

2023-10-05T16:00:00Z

StartDate

string

O momento em que a instância KMS foi ativada.

2023-09-05T12:44:19Z

CaCertificateChainPem

string

A cadeia de certificados CA da instância KMS no formato PEM.

-----BEGIN CERTIFICATE-----\r\nMIIDuzCCAqOgAwIBAgIJALTKwWAjvbMiMA0GCSqGSIb3DQEBCwUAMHQxCzAJBgNV****-----END CERTIFICATE-----

BindVpcs

object

BindVpc

array<object>

A list of associated VPCs.

Nota

You can associate the KMS instance with additional VPCs in the same region, allowing self-managed applications in those VPCs to access the instance. These VPCs can belong to the same or different Alibaba Cloud accounts.

object

Details of an associated VPC.

Nota

You can associate the KMS instance with additional VPCs in the same region, allowing self-managed applications in those VPCs to access the instance. These VPCs can belong to the same or different Alibaba Cloud accounts.

RegionId

string

The region where the VPC is located.

cn-hangzhou

VpcId

string

The ID of the VPC.

vpc-bp19z7djuhtad5dff****

VpcOwnerId

string

The Alibaba Cloud account to which the VPC belongs.

190325303126****

VSwitchId

string

The vSwitch in the VPC.

vsw-bp1i512amhdje10f1****

ChargeType

string

O método de cobrança da instância. Valores válidos:

  • PREPAY: assinatura

  • POSTPAY: pagamento conforme o uso

POSTPAY

ProductVersion

string

A versão da instância KMS.

3

SaleStatus

string

O status de vendas da instância.

Normal

Log

integer

Indica se o registro de logs está ativado para a instância KMS. Valores válidos: 1 (ativado) e 0 (desativado).

1

LogStorage

integer

A capacidade de armazenamento de logs. Unidade: GB.

100

ProductType

string

O tipo de produto.
Assinatura:
kms_ddi_public_cn: site China
kms_ddi_public_intl: site internacional
Pagamento conforme o uso:
kms_ppi_public_cn: site China
kms_ppi_public_intl: site internacional





kms_ddi_public_cn

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "46b4a94a-57d2-44b4-9810-1e87d31abb33",
  "KmsInstance": {
    "InstanceId": "kst-bjj62f5ba3dnpb6v8****",
    "InstanceName": "kst-bjj62f5ba3dnpb6v8****",
    "Status": "Connected",
    "CreateTime": "2023-09-05T12:44:20Z",
    "Spec": 1000,
    "KeyNum": 1000,
    "SecretNum": "10",
    "VpcNum": 5,
    "VpcId": "vpc-bp19z7cwmltad5dff****",
    "ZoneIds": [
      ""
    ],
    "VswitchIds": [
      ""
    ],
    "EndDate": "2023-10-05T16:00:00Z",
    "StartDate": "2023-09-05T12:44:19Z",
    "CaCertificateChainPem": "-----BEGIN CERTIFICATE-----\\r\\nMIIDuzCCAqOgAwIBAgIJALTKwWAjvbMiMA0GCSqGSIb3DQEBCwUAMHQxCzAJBgNV****-----END CERTIFICATE-----",
    "BindVpcs": {
      "BindVpc": [
        {
          "RegionId": "cn-hangzhou",
          "VpcId": "vpc-bp19z7djuhtad5dff****",
          "VpcOwnerId": "190325303126****",
          "VSwitchId": "vsw-bp1i512amhdje10f1****"
        }
      ]
    },
    "ChargeType": "POSTPAY",
    "ProductVersion": "3",
    "SaleStatus": "Normal",
    "Log": 1,
    "LogStorage": 100,
    "ProductType": "kms_ddi_public_cn"
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 IllegalTimestamp The input parameter Timestamp that is mandatory for processing this request is not supplied. The input parameter timestamp indicates that the request is outside the processing time range.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.