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

Consulta las cadenas de instantáneas de los discos. Una cadena de instantáneas consta de todas las instantáneas de un disco. Cada disco corresponde a una cadena de instantáneas.

Descripción de la operación

Cuando llame a esta operación, tenga en cuenta los siguientes puntos:

Los parámetros de solicitud RegionId, DiskIds e InstanceId actúan como filtros. Estos parámetros tienen una relación lógica AND.
Si no especifica ningún parámetro, los filtros no surten efecto. Si tanto DiskIds como SnapshotLinkIds son arreglos vacíos, los filtros se consideran válidos, pero se devuelve un conjunto de resultados vacío.

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:DescribeSnapshotLinks

get

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del disco. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
InstanceId	string	No	El ID de la instancia.	i-bp1h6jmbefj2cyqs****
DiskIds	string	No	Los ID de los discos. Puede especificar hasta 100 ID de discos a la vez. El parámetro DiskIds es un arreglo JSON. Separe varios ID de discos con comas (,).	["d-bp1d6tsvznfghy7y**", "d-bp1ippxbaql9zet7", … "d-bp1ib7bcz07lcxa9**"]
SnapshotLinkIds	string	No	Los ID de las cadenas de instantáneas. Puede especificar hasta 100 ID de cadenas de instantáneas a la vez. El parámetro SnapshotLinkIds es un arreglo JSON. Separe varios ID con comas (,).	["sl-bp1grgphbcc9brb5**", "sl-bp1c4izumvq0i5bs", … "sl-bp1akk7isz866dds**"]
PageNumber	integer	No	El número de página de la lista de estados de discos. Valor mínimo: 1. Valor predeterminado: 1.	1
PageSize	integer	No	El número de entradas por página para una consulta paginada. Valores válidos: de 1 a 100. Valor predeterminado: 10.	50
NextToken	string	No	El token de paginación. Establezca este parámetro en el valor de NextToken devuelto en la llamada a la API anterior.	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	No	El número máximo de entradas por página para una consulta paginada. Valor máximo: 100. Valor predeterminado: Si este parámetro no se especifica o se establece en un valor menor que 10, el valor predeterminado es 10. Si este parámetro se establece en un valor mayor que 100, el valor predeterminado es 100.	10

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
NextToken	string	El token de paginación devuelto en esta llamada.	caeba0bbb2be03f84eb48b699f0a****
PageNumber	integer	El número de página de la lista de cadenas de instantáneas.	1
PageSize	integer	El número de entradas por página que especificó en la solicitud.	50
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
SnapshotLinks	object
SnapshotLink	array<object>	La colección de información de cadenas de instantáneas.
	object
Category	string	El tipo de cadena de instantáneas. Valores válidos: standard: cadena de instantáneas estándar. archive: cadena de instantáneas archivada. flash: cadena de instantáneas de acceso instantáneo.	standard
InstanceId	string	El ID de la instancia.	i-bp1h6jmbefj2cyqs****
InstanceName	string	El nombre de la instancia.	testInstanceName
InstantAccess	boolean	Indica si la función de acceso instantáneo a instantáneas está habilitada. Valores válidos: true: habilitado. Solo los discos ESSD admiten esta función. false: deshabilitado. La instantánea es una instantánea estándar para la que no está habilitada la función de acceso instantáneo a instantáneas. Nota Este parámetro está obsoleto. Las instantáneas estándar de los discos ESSD se han actualizado a acceso instantáneo de forma predeterminada. No se requiere configuración adicional ni se aplican tarifas adicionales.	false
RegionId	string	El ID de la región del disco de origen de la cadena de instantáneas.	cn-hangzhou
SnapshotLinkId	string	El ID de la cadena de instantáneas.	sl-2ze0y1jwzpb1geqx****
SourceDiskId	string	El ID del disco de origen. Este campo se conserva incluso si se ha eliminado el disco de origen de la instantánea.	d-bp1d6tsvznfghy7y****
SourceDiskName	string	El nombre del disco de origen.	testSourceDiskName
SourceDiskSize	integer	La capacidad del disco de origen. Unidad: GiB.	40
SourceDiskType	string	El tipo del disco de origen. Valores válidos: system: disco del sistema. data: disco de datos.	data
TotalCount	integer	El número total de instantáneas.	1
TotalSize	integer	El tamaño total de todas las instantáneas de la cadena de instantáneas. Unidad: bytes.	2097152
TotalCount	integer	El número total de cadenas de instantáneas. Nota Cuando use los parámetros MaxResults y NextToken para una consulta paginada, el valor de TotalCount devuelto no es válido.	9

Ejemplos

Respuesta exitosa

JSON Formato

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "PageNumber": 1,
  "PageSize": 50,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SnapshotLinks": {
    "SnapshotLink": [
      {
        "Category": "standard",
        "InstanceId": "i-bp1h6jmbefj2cyqs****",
        "InstanceName": "testInstanceName",
        "InstantAccess": false,
        "RegionId": "cn-hangzhou",
        "SnapshotLinkId": "sl-2ze0y1jwzpb1geqx****",
        "SourceDiskId": "d-bp1d6tsvznfghy7y****",
        "SourceDiskName": "testSourceDiskName",
        "SourceDiskSize": 40,
        "SourceDiskType": "data",
        "TotalCount": 1,
        "TotalSize": 2097152
      }
    ]
  },
  "TotalCount": 9
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidInstanceId.NotFound	The specified instanceId is not exists.
400	InvalidRegionId	The specified regionId is invalid.	El RegionId especificado no es válido.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	El SnapshotLinkId especificado no es válido.
400	InvalidDiskIds	The specified diskIds is invalid.	El disco especificado no es válido.
500	InternalError	The request processing has failed due to some unknown error.

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.