DescribeInstanceAttribute - Tair (Redis® OSS-Compatible): Central de Documentação do Alibaba Cloud

Obtém os detalhes de uma instância Tair (compatível com Redis).

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

kvstore:DescribeInstanceAttribute

get

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância.	r-bp1zxszhcgatnx****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	CA40C261-EB72-4EDA-AC57-958722162595
Instances	object
DBInstanceAttribute	array<object>	Os detalhes da instância.
	array<object>
VpcId	string	The ID of the virtual private cloud (VPC).	vpc-bp1nme44gek34slfc****
PrivateIp	string	The private IP address of the instance. Nota This parameter is not returned if the network type of the instance is classic network.	172.16.49.***
Capacity	integer	The memory capacity of the instance. Unit: MB.	1024
CreateTime	string	The time when the instance was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.	2019-03-06T10:42:03Z
ConnectionDomain	string	The internal endpoint of the instance.	r-bp1d72gwl41z7f****.redis.rds.aliyuncs.com
IsRds	boolean	Indicates whether the instance is managed by RDS. Valid values: true: The instance is managed by RDS. false: The instance is not managed by RDS.	true
ChargeType	string	The billing method of the instance. Valid values: PrePaid: subscription PostPaid: pay-as-you-go	PostPaid
StorageType	string	The storage type.	essd_pl1
VpcAuthMode	string	The authentication mode for the instance that is deployed in a VPC. Valid values: Open: Password authentication is enabled. Close: Password-free access is enabled.	Open
ArchitectureType	string	The architecture of the instance. Valid values: cluster: The instance is a cluster instance. standard: The instance is a standard instance. rwsplit: The instance is a read/write splitting instance.	standard
AvailabilityValue	string	The availability metric of the instance in the current month.	100%
NetworkType	string	The network type of the instance. Valid values: CLASSIC: classic network VPC: VPC	CLASSIC
Port	integer	The service port of the instance.	6379
SecondaryZoneId	string	The ID of the secondary zone. Nota If the instance is not deployed in a secondary zone, this parameter is not returned.	cn-hongkong-h
PackageType	string	The edition of the instance. Valid values: standard: standard edition customized: The customized edition is discontinued.	standard
EngineVersion	string	The database engine version of the instance. Valid values: 2.8, 4.0, 5.0, 6.0, and 7.0.	4.0
Config	string	The parameter settings of the instance. The settings are in the JSON format. For more information, see Parameters. To view the audit log configuration, call the DescribeAuditLogConfig operation.	{\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64}
VpcCloudInstanceId	string	The ID of the instance that is deployed in a VPC.	r-bp1d72gwl41z7f****
Bandwidth	integer	The bandwidth of the instance. Unit: Mbit/s.	10
InstanceName	string	The name of the instance.	apitest
SecurityIPList	string	The IP address whitelist.	127.0.0.1
ShardCount	integer	The number of shards.	2
ReplicaCount	integer	The number of replica nodes in the primary zone. Nota The ReplicaCount and SlaveReplicaCount parameters are returned only for cloud-native instances. If the instance uses the cluster architecture, these parameters specify the number of replica nodes per shard in the primary and secondary zones.	1
SlaveReplicaCount	integer	The number of replica nodes in the secondary zone.	1
ReadOnlyCount	integer	The number of read-only nodes in the primary zone. Nota The ReadOnlyCount and SlaveReadOnlyCount parameters are returned only for cloud-native instances for which read/write splitting is enabled. If the instance uses the cluster architecture, these parameters specify the number of read-only nodes per shard in the primary and secondary zones.	5
SlaveReadOnlyCount	integer	The number of read-only nodes in the secondary zone. This parameter is returned only when read/write splitting is enabled for an instance that is deployed in multiple zones.	2
GlobalInstanceId	string	The ID of the distributed instance. Nota This parameter is returned only for child instances of a distributed instance.	gr-bp14rkqrhac****
QPS	integer	The maximum queries per second (QPS).	100000
AuditLogRetention	string	The retention period of the audit log. Unit: days. A value of 0 indicates that the audit log feature is disabled. For more information about how to enable the audit log feature, see Enable audit logging.	15
ZoneType	string	The zone type of the instance. Valid values: singlezone: single-zone doublezone: multi-zone	singlezone
MaintainStartTime	string	The start time of the maintenance window. The time is in the HH:mmZ format and is displayed in UTC.	18:00Z
MaintainEndTime	string	The end time of the maintenance window. The time is in the HH:mmZ format and is displayed in UTC.	22:00Z
InstanceClass	string	The instance type. For more information, see Instance types.	redis.master.small.default
RealInstanceClass	string	If the instance is a cloud-native cluster instance, this parameter indicates the actual instance type of the shards. In this case, the InstanceClass parameter indicates a virtual instance type. Nota To query the fees for an instance of this instance type, specify the value of this parameter in the DescribePrice operation.	tair.rdb.with.proxy.1g
InstanceId	string	The instance ID.	r-bp1d72gwl41z7f****
InstanceType	string	The database engine. Valid values: Tair Redis: ApsaraDB for Redis Community Edition instances and classic ApsaraDB for Redis Enhanced Edition (Tair) memory-type instances are of the Redis database engine. Memcache	Redis
HasRenewChangeOrder	string	Indicates whether a pending order for renewal or configuration change exists for the instance. Valid values: true false	false
InstanceReleaseProtection	boolean	Indicates whether release protection is enabled for the instance. Valid values: true: Release protection is enabled. false: Release protection is disabled.	false
ReplicationMode	string	The replication architecture. Valid values: master-slave: master-replica architecture cluster: cluster architecture, which includes read/write splitting and cluster instances db: cloud-native sharded cluster architecture	master-slave
RegionId	string	The region ID.	cn-hangzhou
EndTime	string	The expiration time of the subscription instance. The time is in the yyyy-MM-ddTHH:mm:ssZ format and is displayed in UTC.	2019-04-06T10:42:03Z
VSwitchId	string	The vSwitch ID.	vsw-bp1e7clcw529l773d****
ReplicaId	string	The ID of the replica node.	bls-awxxxxxxxxxxxxx
NodeType	string	The node type. Valid values: double: The instance has two data nodes. single: The instance has a single data node. readone: The read/write splitting instance has one read-only node. readthree: The read/write splitting instance has three read-only nodes.	double
Connections	integer	The maximum number of connections.	10000
BackupLogStartTime	string	The earliest point in time to which data can be restored. The time is in the yyyy-MM-ddTHH:mm:ssZ format and is displayed in UTC. Nota This parameter is returned only if the Data Flashback feature is enabled for the instance. When you call the RestoreInstance operation to perform a data flashback, this is the earliest value that can be specified for the RestoreTime parameter.	2021-07-06T05:49:55Z
ResourceGroupId	string	The ID of the resource group to which the instance belongs.	rg-acfmyiu4ekp****
ZoneId	string	The zone ID.	cn-hongkong-b
InstanceStatus	string	The state of the instance. Valid values: Normal: The instance is running as expected. Creating: The instance is being created. Changing: The instance configuration is being changed. Inactive: The instance is disabled. Flushing: The instance is being released. Released: The instance is released. Transforming: The billing method of the instance is being changed. Migrating: The instance is being migrated. BackupRecovering: The instance is being restored from a backup. MinorVersionUpgrading: The minor version of the instance is being updated. NetworkModifying: The network type of the instance is being changed. SSLModifying: The SSL certificate of the instance is being changed. MajorVersionUpgrading: The major version of the instance is being upgraded. The instance remains accessible during the upgrade. Nota For more information about instance states and their impacts, see Instance states.	Normal
Engine	string	The database engine. The value is fixed as Redis.	Redis
Storage	string	The storage space of an ApsaraDB for Redis Enhanced Edition (Tair) instance that uses enhanced SSDs (ESSDs).	50
CloudType	string	This parameter is returned only for ApsaraDB for Redis instances that are created in Alibaba Cloud clouds.	cloudbox
IsOrderCompleted	boolean	Indicates whether a configuration change is complete. Valid values: true: The configuration change is complete, or no configuration change is in progress. false: The configuration change is in progress.	true
IsSupportTDE	boolean	Indicates whether Transparent Data Encryption (TDE) is supported. Valid values: true: TDE is supported. This feature is supported only for ApsaraDB for Redis Enhanced Edition (Tair) memory-type instances. false: TDE is not supported.	true
Tags	object
Tag	array<object>	The tags.
	object	The tag.
Key	string	The key of the tag.	tagkey
Value	string	The value of the tag.	tagvalue
AutoSecondaryZone	boolean	Indicates whether the secondary zone is automatically selected. Valid values: true: The secondary zone is automatically selected. false: The secondary zone is not automatically selected.	true
ComputingType	string

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CA40C261-EB72-4EDA-AC57-958722162595",
  "Instances": {
    "DBInstanceAttribute": [
      {
        "VpcId": "vpc-bp1nme44gek34slfc****",
        "PrivateIp": "172.16.49.***",
        "Capacity": 1024,
        "CreateTime": "2019-03-06T10:42:03Z",
        "ConnectionDomain": "r-bp1d72gwl41z7f****.redis.rds.aliyuncs.com",
        "IsRds": true,
        "ChargeType": "PostPaid",
        "StorageType": "essd_pl1",
        "VpcAuthMode": "Open",
        "ArchitectureType": "standard",
        "AvailabilityValue": "100%",
        "NetworkType": "CLASSIC",
        "Port": 6379,
        "SecondaryZoneId": "cn-hongkong-h",
        "PackageType": "standard",
        "EngineVersion": "4.0",
        "Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
        "VpcCloudInstanceId": "r-bp1d72gwl41z7f****",
        "Bandwidth": 10,
        "InstanceName": "apitest",
        "SecurityIPList": "127.0.0.1",
        "ShardCount": 2,
        "ReplicaCount": 1,
        "SlaveReplicaCount": 1,
        "ReadOnlyCount": 5,
        "SlaveReadOnlyCount": 2,
        "GlobalInstanceId": "gr-bp14rkqrhac****",
        "QPS": 100000,
        "AuditLogRetention": "15",
        "ZoneType": "singlezone",
        "MaintainStartTime": "18:00Z",
        "MaintainEndTime": "22:00Z",
        "InstanceClass": "redis.master.small.default",
        "RealInstanceClass": "tair.rdb.with.proxy.1g",
        "InstanceId": "r-bp1d72gwl41z7f****",
        "InstanceType": "Redis",
        "HasRenewChangeOrder": "false",
        "InstanceReleaseProtection": false,
        "ReplicationMode": "master-slave",
        "RegionId": "cn-hangzhou",
        "EndTime": "2019-04-06T10:42:03Z",
        "VSwitchId": "vsw-bp1e7clcw529l773d****",
        "ReplicaId": "bls-awxxxxxxxxxxxxx",
        "NodeType": "double",
        "Connections": 10000,
        "BackupLogStartTime": "2021-07-06T05:49:55Z",
        "ResourceGroupId": "rg-acfmyiu4ekp****",
        "ZoneId": "cn-hongkong-b",
        "InstanceStatus": "Normal",
        "Engine": "Redis",
        "Storage": "50",
        "CloudType": "cloudbox",
        "IsOrderCompleted": true,
        "IsSupportTDE": true,
        "Tags": {
          "Tag": [
            {
              "Key": "tagkey",
              "Value": "tagvalue"
            }
          ]
        },
        "AutoSecondaryZone": true,
        "ComputingType": ""
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.