Volumes - Get
Obtener un volumen.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}/volumes/{volumeName}?api-version=2022-12-01-preview
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
elastic
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[A-Za-z0-9]+((-|_)[a-z0-9A-Z]+)*$ |
Nombre de ElasticSan. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas. |
subscription
|
path | True |
string minLength: 1 |
Identificador de la suscripción de destino. |
volume
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[A-Za-z0-9]+((-|_)[a-z0-9A-Z]+)*$ |
Nombre del objeto VolumeGroup. |
volume
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-z0-9]+(-[a-z0-9A-Z]+)*$ |
Nombre del volumen. |
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Operación completada correctamente; volumen recuperado. |
|
Other Status Codes |
Error del proveedor de recursos elasticSan. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Volumes_Get_Maximum |
Volumes_Get_Minimum |
Volumes_Get_MaximumSet_Gen
Solicitud de ejemplo
Respuesta de muestra
{
"properties": {
"volumeId": "hkbhievbyopwjqawbyvqi",
"creationData": {
"createSource": "None",
"sourceUri": " ARM Id of resource"
},
"sizeGiB": 23,
"storageTarget": {
"targetIqn": "yuuex",
"targetPortalHostname": "yktnmynpdjpmztwuwcvipp",
"targetPortalPort": 3,
"provisioningState": "Succeeded",
"status": "Invalid"
}
},
"systemData": {
"createdBy": "zloujisrarsox",
"createdByType": "User",
"createdAt": "2023-07-04T05:52:15.371Z",
"lastModifiedBy": "lmdztjjcmdfzam",
"lastModifiedByType": "User",
"lastModifiedAt": "2023-07-04T05:52:15.371Z"
},
"id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}/volumes/{volumeName}",
"name": "ipmipjggodoxjua",
"type": "Microsoft.ElasticSan/elasticSans"
}
Volumes_Get_MinimumSet_Gen
Solicitud de ejemplo
Respuesta de muestra
{
"properties": {
"volumeId": "hkbhievbyopwjqawbyvqi",
"creationData": {
"createSource": "None",
"sourceUri": " ARM Id of resource"
},
"sizeGiB": 23,
"storageTarget": {
"targetIqn": "yuuex",
"targetPortalHostname": "yktnmynpdjpmztwuwcvipp",
"targetPortalPort": 3,
"provisioningState": "Succeeded",
"status": "Invalid"
}
},
"systemData": {
"createdBy": "zloujisrarsox",
"createdByType": "User",
"createdAt": "2023-07-04T05:52:15.371Z",
"lastModifiedBy": "lmdztjjcmdfzam",
"lastModifiedByType": "User",
"lastModifiedAt": "2023-07-04T05:52:15.371Z"
},
"id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}/volumes/{volumeName}",
"name": "ipmipjggodoxjua",
"type": "Microsoft.ElasticSan/elasticSans"
}
Definiciones
Nombre | Description |
---|---|
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Iscsi |
Información de destino Iscsi |
Operational |
Estado operativo del recurso. |
Provisioning |
Estado de la operación en el recurso. |
Source |
Origen de datos usado al crear el volumen. |
system |
Metadatos relativos a la creación y última modificación del recurso. |
Volume |
Respuesta para la solicitud de volumen. |
Volume |
Esto enumera los posibles orígenes de una creación de volúmenes. |
createdByType
Tipo de identidad que creó el recurso.
Valor | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
IscsiTargetInfo
Información de destino Iscsi
Nombre | Tipo | Description |
---|---|---|
provisioningState |
Estado de la operación en el recurso. |
|
status |
Estado operativo del destino iSCSI. |
|
targetIqn |
string |
iSCSI Target IQN (iSCSI Qualified Name); ejemplo: "iqn.2005-03.org.iscsi:server". |
targetPortalHostname |
string |
Nombre de host del portal de destino iSCSI |
targetPortalPort |
integer (int32) |
Puerto del portal de destino iSCSI |
OperationalStatus
Estado operativo del recurso.
Valor | Description |
---|---|
Healthy | |
Invalid | |
Running | |
Stopped | |
Stopped (deallocated) | |
Unhealthy | |
Unknown | |
Updating |
ProvisioningStates
Estado de la operación en el recurso.
Valor | Description |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Invalid | |
Pending | |
Succeeded | |
Updating |
SourceCreationData
Origen de datos usado al crear el volumen.
Nombre | Tipo | Description |
---|---|---|
createSource |
Esto enumera los posibles orígenes de una creación de volúmenes. |
|
sourceUri |
string |
Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco. Si createOption es Restore, este es el identificador similar a ARM del punto de restauración del disco de origen. |
systemData
Metadatos relativos a la creación y última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string (date-time) |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
Volume
Respuesta para la solicitud de volumen.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nombre del recurso |
properties.creationData |
Estado de la operación en el recurso. |
|
properties.sizeGiB |
integer (int64) |
Tamaño del volumen. |
properties.storageTarget |
Información de destino de almacenamiento |
|
properties.volumeId |
string |
Identificador único del volumen en formato GUID |
systemData |
Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy. |
|
type |
string |
Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
VolumeCreateOption
Esto enumera los posibles orígenes de una creación de volúmenes.
Valor | Description |
---|---|
None |