DescribeInstanceAttribute - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta la información de atributos de una instancia de ECS especificada.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:DescribeInstanceAttribute

get

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia.	i-uf6f5trc95ug8t33****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Status	string	El estado de la instancia. Valores válidos: Pending: en proceso de creación. Running: en ejecución. Starting: en proceso de inicio. Stopping: en proceso de detención. Stopped: detenida.	Running
SerialNumber	string	El número de serie de la instancia.	51d1353b-22bf-4567-a176-8b3e12e4****
CreationTime	string	La hora en que se creó la instancia. La hora sigue el estándar ISO 8601 con el formato yyyy-MM-ddTHH:mmZ. La hora se muestra en UTC. Para obtener más información, consulte ISO 8601.	2017-12-10T04:04Z
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Description	string	La descripción de la instancia.	testDescription
InstanceName	string	El nombre de la instancia.	testInstanceName
InstanceNetworkType	string	El tipo de red de la instancia. Valores válidos: vpc: Virtual Private Cloud (VPC). classic: red clásica. La red clásica está obsoleta. Para obtener más información, consulte Aviso de obsolescencia.	vpc
Memory	integer	El tamaño de memoria. Unidad: MiB.	16384
ImageId	string	El ID de la imagen que ejecuta la instancia.	m-bp1h46wfpjsjastc****
ClusterId	string	El ID del clúster al que pertenece la instancia. Nota Este parámetro quedará obsoleto próximamente. Para garantizar la compatibilidad futura, utilice otros parámetros.	cls-bp67acfmxazb4p****
VlanId	string	El ID de VLAN de la instancia. Nota Este parámetro quedará obsoleto próximamente. Para garantizar la compatibilidad futura, utilice otros parámetros.	10
StoppedMode	string	Indica si la instancia continúa facturándose después de detenerse. Valores válidos: KeepCharging: La instancia continúa facturándose después de detenerse. Se conservan recursos como vCPU, memoria y direcciones IP públicas. StopCharging: La instancia no se factura después de detenerse. Se liberan recursos como vCPU, memoria y direcciones IP públicas. La posibilidad de reiniciar la instancia depende de la disponibilidad de recursos en la región actual. Not-applicable: La instancia no admite el modo económico.	KeepCharging
HostName	string	El nombre de host de la instancia.	testHostName
InstanceId	string	El ID de la instancia.	i-uf6f5trc95ug8t33****
InstanceType	string	El tipo de la instancia.	ecs.g5.large
InternetMaxBandwidthIn	integer	El ancho de banda público entrante máximo. Unidad: Mbit/s.	50
InternetMaxBandwidthOut	integer	El ancho de banda público saliente máximo. Unidad: Mbit/s.	5
RegionId	string	El ID de región de la instancia.	cn-hangzhou
InstanceChargeType	string	El método de facturación de la instancia. Valores válidos: PrePaid: suscripción. PostPaid: pago por uso.	PrePaid
IoOptimized	string	Indica si la instancia está optimizada para E/S. Valores válidos: optimized: optimizada para E/S. none: no optimizada para E/S.	optimized
Cpu	integer	El número de núcleos de vCPU.	8
ExpiredTime	string	La hora de vencimiento. La hora sigue el estándar ISO 8601 con el formato yyyy-MM-ddTHH:mmZ. La hora se muestra en UTC. Para obtener más información, consulte ISO 8601.	2017-12-10T04:04Z
ZoneId	string	El ID de zona de la instancia.	cn-hangzhou-g
InternetChargeType	string	El método de facturación del ancho de banda público. Valores válidos: PayByBandwidth: pago por ancho de banda. PayByTraffic: pago por tráfico. Nota En el modo pago por tráfico, los anchos de banda entrantes y salientes máximos se utilizan como límites superiores de ancho de banda en lugar de métricas de rendimiento garantizado. Cuando se produce contención de recursos, los anchos de banda máximos pueden verse limitados. Si requiere un ancho de banda garantizado, utilice el modo pago por ancho de banda.	PayByTraffic
CreditSpecification	string	El modo de ejecución de la instancia ampliable. Valores válidos: Standard: modo estándar. Para obtener más información sobre el rendimiento de la instancia, consulte Modo de rendimiento. Unlimited: modo ilimitado. Para obtener más información sobre el rendimiento de la instancia, consulte Modo de rendimiento.	Standard
SecurityGroupIds	object
SecurityGroupId	array	Los security groups a los que pertenece la instancia.
	string	El security group al que pertenece la instancia.	sg-bp1fg655nh68xyz9i****
PublicIpAddress	object
IpAddress	array	La lista de direcciones IP públicas de la instancia.
	string	La dirección IP pública de la instancia.	121.40..
InnerIpAddress	object
IpAddress	array	La lista de direcciones IP de red interna de la instancia de tipo red clásica. Nota La red clásica está obsoleta. Para obtener más información, consulte Aviso de obsolescencia.
	string	La dirección IP de red interna de la instancia de tipo red clásica.	192.168..
VpcAttributes	object	Los atributos de VPC.
VpcId	string	El ID de VPC.	vpc-wz9e4e9pmbcnj6ki6****
NatIpAddress	string	La dirección IP del servicio en la nube, que se utiliza para la comunicación de red entre servicios en la nube conectados a VPC.	172.17..
VSwitchId	string	El ID de vSwitch.	vsw-uf6ixacqz8osrwnqb****
PrivateIpAddress	object
IpAddress	array	La lista de direcciones IP privadas.
	string	La dirección IP privada.	192.168..
EipAddress	object	La información de vinculación de Elastic IP Address (EIP).
InternetChargeType	string	El método de facturación del ancho de banda público. Valores válidos: PayByBandwidth: pago por ancho de banda. PayByTraffic: pago por tráfico. Nota En el modo pago por tráfico, los anchos de banda entrantes y salientes máximos se utilizan como límites superiores de ancho de banda en lugar de métricas de rendimiento garantizado. Cuando se produce contención de recursos, los anchos de banda máximos pueden verse limitados. Si requiere un ancho de banda garantizado, utilice el modo pago por ancho de banda.	PayByTraffic
IpAddress	string	La dirección EIP.	30.21..
Bandwidth	integer	El límite de ancho de banda público de la EIP. Unidad: Mbit/s.	8
AllocationId	string	El ID de la EIP.	eip-wz9uilio26dfscamm****
DedicatedHostAttribute	object	Los atributos del host dedicado, que consisten en el ID del clúster de hosts dedicados (DedicatedHostClusterId), el ID del host dedicado (DedicatedHostId) y el nombre del host dedicado (DedicatedHostName).
DedicatedHostName	string	El nombre del host dedicado.	ecs-autoui-create-ddh-temp
DedicatedHostId	string	El ID del host dedicado.	dh-2ze7qrzz6lvbfhr0****
OperationLocks	object
LockReason	array<object>	La lista de motivos de bloqueo.
	object	El motivo de bloqueo.
LockReason	string	El motivo de bloqueo. Valores válidos: financial: La instancia está bloqueada debido a pagos atrasados. security: La instancia está bloqueada por motivos de seguridad. Recycling: La instancia spot está bloqueada y pendiente de liberación. dedicatedhostfinancial: La instancia de ECS está bloqueada porque el host dedicado tiene un pago atrasado. refunded: La instancia está bloqueada porque se ha realizado un reembolso.	financial
EnableJumboFrame	boolean	Indica si la función de tramas Jumbo está habilitada para la instancia de ECS. Valores válidos: true: habilitada. false: no habilitada. Para obtener más información, consulte MTU de instancia de ECS.	false
EnableNetworkEncryption	boolean	Indica si el cifrado de tráfico de red VPC está habilitado para la instancia. Valores válidos: true: habilitado. false: no habilitado. Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.	True
NetworkOptions	object	Los atributos relacionados con la red. Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
EnableJumboFrame	boolean	Indica si la función de tramas Jumbo está habilitada para la instancia. Valores válidos: true: habilitada. false: no habilitada. Para obtener más información, consulte MTU de instancia de ECS. Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.	false
EnableNetworkEncryption	boolean	Indica si el cifrado de tráfico de red VPC está habilitado para la instancia. Valores válidos: true: habilitado. false: no habilitado. Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.	False
BandwidthWeighting	string	La ponderación de ancho de banda. Los diferentes tipos de instancias admiten diferentes valores. Puede llamar a DescribeInstanceTypes para consultar los valores de ponderación de ancho de banda admitidos por el tipo de instancia actual. Valores válidos: Vpc-L1 : Vpc-L1 Vpc-L2 : Vpc-L2 Ebs-L1 : Ebs-L1 Ebs-L2 : Ebs-L2 Default : Default.	Vpc-L1
SecurityOptions	object
EnableSecureBoot	boolean

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Status": "Running",
  "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e4****",
  "CreationTime": "2017-12-10T04:04Z",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Description": "testDescription",
  "InstanceName": "testInstanceName",
  "InstanceNetworkType": "vpc",
  "Memory": 16384,
  "ImageId": "m-bp1h46wfpjsjastc****",
  "ClusterId": "cls-bp67acfmxazb4p****",
  "VlanId": "10",
  "StoppedMode": "KeepCharging",
  "HostName": "testHostName",
  "InstanceId": "i-uf6f5trc95ug8t33****",
  "InstanceType": "ecs.g5.large",
  "InternetMaxBandwidthIn": 50,
  "InternetMaxBandwidthOut": 5,
  "RegionId": "cn-hangzhou",
  "InstanceChargeType": "PrePaid",
  "IoOptimized": "optimized",
  "Cpu": 8,
  "ExpiredTime": "2017-12-10T04:04Z",
  "ZoneId": "cn-hangzhou-g",
  "InternetChargeType": "PayByTraffic",
  "CreditSpecification": "Standard",
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp1fg655nh68xyz9i****"
    ]
  },
  "PublicIpAddress": {
    "IpAddress": [
      "121.40.**.**"
    ]
  },
  "InnerIpAddress": {
    "IpAddress": [
      "192.168.**.**"
    ]
  },
  "VpcAttributes": {
    "VpcId": "vpc-wz9e4e9pmbcnj6ki6****",
    "NatIpAddress": "172.17.**.**",
    "VSwitchId": "vsw-uf6ixacqz8osrwnqb****",
    "PrivateIpAddress": {
      "IpAddress": [
        "192.168.**.**"
      ]
    }
  },
  "EipAddress": {
    "InternetChargeType": "PayByTraffic",
    "IpAddress": "30.21.**.**",
    "Bandwidth": 8,
    "AllocationId": "eip-wz9uilio26dfscamm****"
  },
  "DedicatedHostAttribute": {
    "DedicatedHostName": "ecs-autoui-create-ddh-temp",
    "DedicatedHostId": "dh-2ze7qrzz6lvbfhr0****"
  },
  "OperationLocks": {
    "LockReason": [
      {
        "LockReason": "financial"
      }
    ]
  },
  "EnableJumboFrame": false,
  "EnableNetworkEncryption": true,
  "NetworkOptions": {
    "EnableJumboFrame": false,
    "EnableNetworkEncryption": true,
    "BandwidthWeighting": "Vpc-L1"
  },
  "SecurityOptions": {
    "EnableSecureBoot": false
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
500	InternalError	The request processing has failed due to some unknown error.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	The specified instanceId is invalid.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.