Clouds - Get

Dienst:

Azure Arc enabled SCVMM

API-Version:

2024-06-01

Ruft eine Cloud ab.
Implementiert die Cloud GET-Methode.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/clouds/{cloudResourceName}?api-version=2024-06-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
cloudResourceName	path	True	string	Name der Cloud. RegEx-Muster: [a-zA-Z0-9-_\.]
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string uuid	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	Cloud	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Clouds_Get_MaximumSet

Clouds_Get_MinimumSet

Clouds_Get_MaximumSet

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/clouds/_?api-version=2024-06-01

Beispiel für eine Antwort

Statuscode:

200

{
  "properties": {
    "inventoryItemId": "qjd",
    "uuid": "12345678-1234-1234-1234-12345678abcd",
    "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
    "cloudName": "menarjsplhcqvnkjdwieroir",
    "cloudCapacity": {
      "cpuCount": 4,
      "memoryMB": 19,
      "vmCount": 28
    },
    "storageQoSPolicies": [
      {
        "name": "hvqcentnbwcunxhzfavyewhwlo",
        "id": "oclhgkydaw",
        "iopsMaximum": 6,
        "iopsMinimum": 25,
        "bandwidthLimit": 26,
        "policyId": "lvcylbmxrqjgarvhfny"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key4295": "wngosgcbdifaxdobufuuqxtho"
  },
  "location": "khwsdmaxfhmbu",
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/clouds/cloudResourceName",
  "name": "wwcwalpiufsfbnydxpr",
  "type": "qnaaimszbuokldohwrdfuiitpy",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

Clouds_Get_MinimumSet

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/clouds/i?api-version=2024-06-01

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/clouds/cloudResourceName",
  "extendedLocation": {},
  "location": "khwsdmaxfhmbu"
}

Definitionen

Name	Beschreibung
Cloud	Die Clouds-Ressourcendefinition.
CloudCapacity	Cloudkapazitätsmodell
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ExtendedLocation	Der erweiterte Speicherort.
ProvisioningState	Der Bereitstellungsstatus der Ressource.
StorageQosPolicy	Die StorageQoSPolicy-Definition.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

Cloud

Die Clouds-Ressourcendefinition.

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Der erweiterte Speicherort.
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.cloudCapacity	CloudCapacity	Kapazität der Cloud.
properties.cloudName	string	Name der Cloud in VmmServer.
properties.inventoryItemId	string	Dient zum Abrufen oder Festlegen der Bestandselement-ID für die Ressource.
properties.provisioningState	ProvisioningState	Bereitstellungsstatus der Ressource.
properties.storageQoSPolicies	StorageQosPolicy[]	Liste der für die Cloud verfügbaren QoS-Richtlinien.
properties.uuid	string	Eindeutige ID der Cloud.
properties.vmmServerId	string	ARM-ID der vmmServer-Ressource, in der sich diese Ressource befindet.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

CloudCapacity

Cloudkapazitätsmodell

Name	Typ	Beschreibung
cpuCount	integer	CPUCount gibt die maximale Anzahl von CPUs an, die in der Cloud zugeordnet werden können.
memoryMB	integer	MemoryMB gibt einen Speicherauslastungsgrenzwert in Megabyte an.
vmCount	integer	VMCount gibt die maximale Anzahl von VMs an, die in der Cloud bereitgestellt werden können.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ExtendedLocation

Der erweiterte Speicherort.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	string	Der erweiterte Standorttyp.

ProvisioningState

Der Bereitstellungsstatus der Ressource.

Name	Typ	Beschreibung
Accepted	string	Die Ressource wurde akzeptiert.
Canceled	string	Die Ressourcenerstellung wurde abgebrochen.
Created	string	Die Ressource wurde erstellt.
Deleting	string	Die Ressource wird gelöscht.
Failed	string	Fehler bei der Ressourcenerstellung.
Provisioning	string	Die Ressource wird bereitgestellt.
Succeeded	string	Ressource wurde erstellt.
Updating	string	Die Ressource wird aktualisiert.

StorageQosPolicy

Die StorageQoSPolicy-Definition.

Name	Typ	Beschreibung
bandwidthLimit	integer	Der Bandbreitengrenzwert für Internetdatenverkehr.
id	string	Die ID der QoS-Richtlinie.
iopsMaximum	integer	Die maximalen E/A-Vorgänge pro Sekunde.
iopsMinimum	integer	Die mindesten E/A-Vorgänge pro Sekunde.
name	string	Der Name der Richtlinie.
policyId	string	Die zugrunde liegende Richtlinie.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.