Compartir a través de


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
elasticSanName
path True

string

minLength: 3
maxLength: 24
pattern: ^[A-Za-z0-9]+((-|_)[a-z0-9A-Z]+)*$

Nombre de ElasticSan.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

volumeGroupName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+((-|_)[a-z0-9A-Z]+)*$

Nombre del objeto VolumeGroup.

volumeName
path True

string

minLength: 3
maxLength: 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

Volume

Operación completada correctamente; volumen recuperado.

Other Status Codes

ErrorResponse

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_MaximumSet_Gen
Volumes_Get_MinimumSet_Gen

Volumes_Get_MaximumSet_Gen

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/subscriptionid/resourceGroups/resourcegroupname/providers/Microsoft.ElasticSan/elasticSans/elasticsanname/volumegroups/volumegroupname/volumes/volumename?api-version=2022-12-01-preview

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

GET https://management.azure.com/subscriptions/subscriptionid/resourceGroups/resourcegroupname/providers/Microsoft.ElasticSan/elasticSans/elasticsanname/volumegroups/volumegroupname/volumes/volumename?api-version=2022-12-01-preview

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
createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

IscsiTargetInfo

Información de destino Iscsi

OperationalStatus

Estado operativo del recurso.

ProvisioningStates

Estado de la operación en el recurso.

SourceCreationData

Origen de datos usado al crear el volumen.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Volume

Respuesta para la solicitud de volumen.

VolumeCreateOption

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

IscsiTargetInfo

Información de destino Iscsi

Nombre Tipo Description
provisioningState

ProvisioningStates

Estado de la operación en el recurso.

status

OperationalStatus

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

VolumeCreateOption

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

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

createdByType

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

SourceCreationData

Estado de la operación en el recurso.

properties.sizeGiB

integer (int64)

Tamaño del volumen.

properties.storageTarget

IscsiTargetInfo

Información de destino de almacenamiento

properties.volumeId

string

Identificador único del volumen en formato GUID

systemData

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