Cloud Services - Get

サービス:: Compute

API バージョン:: 2024-11-04

クラウドサービスに関する情報を表示します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}?api-version=2024-11-04

URI パラメーター

名前	/	必須	型	説明
cloudServiceName	path	True	string	クラウドサービスの名前。
resourceGroupName	path	True	string	リソースグループの名前。
subscriptionId	path	True	string	Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。
api-version	query	True	string	クライアント API のバージョン。

応答

名前	型	説明
200 OK	CloudService	[OK]
Other Status Codes	CloudError	エラー

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Get Cloud Service with Multiple Roles and RDP Extension

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}?api-version=2024-11-04

応答のサンプル

状態コード:: 200

{
  "name": "{cs-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}",
  "type": "Microsoft.Compute/cloudServices",
  "location": "eastus2euap",
  "properties": {
    "configuration": "{ServiceConfiguration}",
    "upgradeMode": "Auto",
    "roleProfile": {
      "roles": [
        {
          "name": "ContosoFrontend",
          "sku": {
            "name": "Standard_D1_v2",
            "tier": "Standard",
            "capacity": 2
          }
        },
        {
          "name": "ContosoBackend",
          "sku": {
            "name": "Standard_D1_v2",
            "tier": "Standard",
            "capacity": 2
          }
        }
      ]
    },
    "osProfile": {
      "secrets": []
    },
    "networkProfile": {
      "loadBalancerConfigurations": [
        {
          "name": "contosolb",
          "properties": {
            "frontendIpConfigurations": [
              {
                "name": "contosofe",
                "properties": {
                  "publicIPAddress": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Network/publicIPAddresses/contosopublicip"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    "extensionProfile": {
      "extensions": [
        {
          "name": "RDPExtension",
          "properties": {
            "autoUpgradeMinorVersion": false,
            "provisioningState": "Succeeded",
            "rolesAppliedTo": [
              "*"
            ],
            "publisher": "Microsoft.Windows.Azure.Extensions",
            "type": "RDP",
            "typeHandlerVersion": "1.2",
            "settings": "<PublicConfig><UserName>userazure</UserName><Expiration>01/12/2022 16:29:02</Expiration></PublicConfig>"
          }
        }
      ]
    },
    "provisioningState": "Succeeded",
    "uniqueId": "4ccb4323-4740-4545-bb81-780b27375947"
  },
  "systemData": {
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedAt": "2020-01-01T17:18:19.1234567Z"
  }
}

定義

名前	説明
ApiError	API エラー。
ApiErrorBase	API エラーベース。
CloudError	コンピュート・サービスからのエラー・レスポンス。
CloudService	クラウドサービスについて説明します。
CloudServiceExtensionProfile	クラウドサービス拡張機能プロファイルについて説明します。
CloudServiceExtensionProperties	拡張機能のプロパティ。
CloudServiceNetworkProfile	クラウドサービスのネットワークプロファイル。
CloudServiceOsProfile	クラウドサービスの OS プロファイルについて説明します。
CloudServiceProperties	クラウドサービスのプロパティ
CloudServiceRoleProfile	クラウドサービスのロールプロファイルについて説明します。
CloudServiceRoleProfileProperties	ロールのプロパティについて説明します。
CloudServiceRoleSku	クラウドサービスロール SKU について説明します。
CloudServiceSlotType	クラウドサービスのスロットの種類。使用可能な値は次のとおりです。生産ステージングの指定しない場合、既定値は Production です。
CloudServiceUpgradeMode	クラウドサービスの更新モード。ロールインスタンスは、サービスのデプロイ時に更新ドメインに割り当てられます。更新プログラムは、各更新ドメインで手動で開始することも、すべての更新ドメインで自動的に開始することもできます。使用可能な値は次のとおりです。自動手動同時指定しない場合、既定値は Auto です。[手動] に設定されている場合は、更新プログラムを適用するために PUT UpdateDomain を呼び出す必要があります。 [自動] に設定すると、更新プログラムは各更新ドメインに順番に自動的に適用されます。
CloudServiceVaultAndSecretReference	拡張機能の保護された設定。ロールインスタンスに送信される前に暗号化された KeyVault を使用して参照されます。
CloudServiceVaultCertificate	Key Vault 内の 1 つの証明書参照と、証明書がロールインスタンスのどこに存在するかについて説明します。
CloudServiceVaultSecretGroup	すべて同じ Key Vault 内にある証明書のセットについて説明します。
createdByType	リソースを作成した ID の種類。
Extension	クラウドサービス拡張機能について説明します。
InnerError	内部エラーの詳細。
LoadBalancerConfiguration	ロード・バランサの構成について説明します。
LoadBalancerConfigurationProperties	ロード・バランサ構成のプロパティについて説明します。
LoadBalancerFrontendIpConfiguration	ロードバランサーに使用するフロントエンド IP を指定します。 IPv4 フロントエンド IP アドレスのみがサポートされています。各ロードバランサー構成には、フロントエンド IP 構成が 1 つだけ必要です。
LoadBalancerFrontendIpConfigurationProperties	クラウドサービスの IP 構成について説明します
SubResource
systemData	リソースの作成と最後の変更に関連するメタデータ。

ApiError

Object

API エラー。

名前	型	説明
code	string	エラーコード。
details	ApiErrorBase[]	Api エラーの詳細
innererror	InnerError	Api 内部エラー
message	string	エラーメッセージ。
target	string	特定のエラーのターゲット。

ApiErrorBase

Object

API エラーベース。

名前	型	説明
code	string	エラーコード。
message	string	エラーメッセージ。
target	string	特定のエラーのターゲット。

CloudError

Object

コンピュート・サービスからのエラー・レスポンス。

名前	型	説明
error	ApiError	API エラー。

CloudService

Object

クラウドサービスについて説明します。

名前	型	説明
id	string	リソース ID。
location	string	リソースの場所。
name	string	リソース名。
properties	CloudServiceProperties	クラウドサービスのプロパティ
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
tags	object	リソースタグ。
type	string	リソースの種類。
zones	string[]	リソースの論理可用性ゾーンの一覧。リストには、クラウドサービスをプロビジョニングする必要があるゾーンが 1 つだけ含まれている必要があります。このフィールドは省略可能です。

CloudServiceExtensionProfile

Object

クラウドサービス拡張機能プロファイルについて説明します。

名前	型	説明
extensions	Extension[]	クラウドサービスの拡張機能の一覧。

CloudServiceExtensionProperties

Object

拡張機能のプロパティ。

名前	型	説明
autoUpgradeMinorVersion	boolean	プラットフォームが使用可能になったときに typeHandlerVersion を上位のマイナーバージョンに自動的にアップグレードできるかどうかを明示的に指定します。
forceUpdateTag	string	指定されたパブリック設定と保護された設定を強制的に適用するタグ。タグ値を変更すると、パブリックまたは保護された設定を変更せずに拡張機能を再実行できます。 forceUpdateTag が変更されていない場合でも、ハンドラーによってパブリック設定または保護された設定に対する更新が適用されます。 forceUpdateTag も public 設定や protected 設定も変更されない場合、拡張機能は同じシーケンス番号を持つロールインスタンスに流れ、再実行するかどうかはハンドラー実装次第です
protectedSettings	object	ロールインスタンスに送信される前に暗号化される拡張機能の保護された設定。
protectedSettingsFromKeyVault	CloudServiceVaultAndSecretReference	拡張機能の保護された設定。ロールインスタンスに送信される前に暗号化された KeyVault を使用して参照されます。
provisioningState	string	プロビジョニング状態。応答にのみ表示されます。
publisher	string	拡張ハンドラーの発行元の名前。
rolesAppliedTo	string[]	この拡張機能を適用するロールの省略可能な一覧。プロパティが指定されていない場合、または '*' が指定されている場合、拡張機能はクラウドサービス内のすべてのロールに適用されます。
settings	object	拡張機能のパブリック設定。 JSON 拡張機能の場合、これは拡張機能の JSON 設定です。 XML 拡張機能 (RDP など) の場合、これは拡張機能の XML 設定です。
type	string	拡張機能の種類を指定します。
typeHandlerVersion	string	拡張機能のバージョンを指定します。拡張機能のバージョンを指定します。この要素が指定されていないか、アスタリスク (*) が値として使用されている場合は、拡張機能の最新バージョンが使用されます。メジャーバージョン番号とアスタリスクをマイナーバージョン番号 (X.) として指定した場合は、指定したメジャーバージョンの最新のマイナーバージョンが選択されます。メジャーバージョン番号とマイナーバージョン番号 (X.Y) が指定されている場合は、特定の拡張機能バージョンが選択されます。バージョンが指定されている場合は、ロールインスタンスに対して自動アップグレードが実行されます。

CloudServiceNetworkProfile

Object

クラウドサービスのネットワークプロファイル。

名前	型	説明
loadBalancerConfigurations	LoadBalancerConfiguration[]	ロードバランサーの構成の一覧。クラウドサービスは、パブリックロードバランサーと内部ロードバランサーに対応する最大 2 つのロードバランサー構成を持つことができます。
slotType	CloudServiceSlotType	クラウドサービスのスロットの種類。使用可能な値は次のとおりです。生産ステージングの指定しない場合、既定値は Production です。
swappableCloudService	SubResource	サブジェクトクラウドサービスがスワップを実行できるターゲット IP を含むクラウドサービスの ID 参照。このプロパティは、一度設定すると更新できません。この ID によって参照されるスワップ可能なクラウドサービスが存在する必要があります。そうしないと、エラーがスローされます。

CloudServiceOsProfile

Object

クラウドサービスの OS プロファイルについて説明します。

名前	型	説明
secrets	CloudServiceVaultSecretGroup[]	ロールインスタンスにインストールする必要がある証明書のセットを指定します。

CloudServiceProperties

Object

クラウドサービスのプロパティ

名前	型	説明
allowModelOverride	boolean	(省略可能)モデル/テンプレートで指定されたロール SKU プロパティ (roleProfile.roles.sku) が、.cscfg と .csdef で指定されたロールインスタンス数と VM サイズをそれぞれオーバーライドする必要があるかどうかを示します。既定値は `false` です。
configuration	string	クラウドサービスの XML サービス構成 (.cscfg) を指定します。
configurationUrl	string	BLOB サービス内のサービス構成の場所を参照する URL を指定します。サービスパッケージの URL には、任意のストレージアカウントからの Shared Access Signature (SAS) URI を指定できます。これは書き込み専用プロパティであり、GET 呼び出しでは返されません。
extensionProfile	CloudServiceExtensionProfile	クラウドサービス拡張機能プロファイルについて説明します。
networkProfile	CloudServiceNetworkProfile	クラウドサービスのネットワークプロファイル。
osProfile	CloudServiceOsProfile	クラウドサービスの OS プロファイルについて説明します。
packageUrl	string	BLOB サービス内のサービスパッケージの場所を参照する URL を指定します。サービスパッケージの URL には、任意のストレージアカウントからの Shared Access Signature (SAS) URI を指定できます。これは書き込み専用プロパティであり、GET 呼び出しでは返されません。
provisioningState	string	プロビジョニング状態。応答にのみ表示されます。
roleProfile	CloudServiceRoleProfile	クラウドサービスのロールプロファイルについて説明します。
startCloudService	boolean	(省略可能)作成された直後にクラウドサービスを開始するかどうかを示します。既定値は `true` です。 false の場合、サービスモデルはまだデプロイされますが、コードはすぐには実行されません。代わりに、サービスは Start を呼び出すまで PoweredOff になり、その時点でサービスが開始されます。デプロイされたサービスでは、電源がオフになっている場合でも料金が発生します。
uniqueId	string	クラウドサービスの一意の識別子。
upgradeMode	CloudServiceUpgradeMode	クラウドサービスの更新モード。ロールインスタンスは、サービスのデプロイ時に更新ドメインに割り当てられます。更新プログラムは、各更新ドメインで手動で開始することも、すべての更新ドメインで自動的に開始することもできます。使用可能な値は次のとおりです。自動手動同時指定しない場合、既定値は Auto です。[手動] に設定されている場合は、更新プログラムを適用するために PUT UpdateDomain を呼び出す必要があります。 [自動] に設定すると、更新プログラムは各更新ドメインに順番に自動的に適用されます。

CloudServiceRoleProfile

Object

クラウドサービスのロールプロファイルについて説明します。

名前	型	説明
roles	CloudServiceRoleProfileProperties[]	クラウドサービスのロールの一覧。

CloudServiceRoleProfileProperties

Object

ロールのプロパティについて説明します。

名前	型	説明
name	string	リソース名。
sku	CloudServiceRoleSku	クラウドサービスロール SKU について説明します。

CloudServiceRoleSku

Object

クラウドサービスロール SKU について説明します。

名前	型	説明
capacity	integer (int64)	クラウドサービス内のロールインスタンスの数を指定します。
name	string	SKU 名。注: クラウドサービスが現在オンになっているハードウェアで新しい SKU がサポートされていない場合は、クラウドサービスを削除して再作成するか、古い SKU に戻す必要があります。
tier	string	クラウドサービスの階層を指定します。使用可能な値は次のとおりです。標準 Basic

CloudServiceSlotType

列挙

クラウドサービスのスロットの種類。使用可能な値は次のとおりです。

生産

ステージングの

指定しない場合、既定値は Production です。

値	説明
Production
Staging

CloudServiceUpgradeMode

列挙

クラウドサービスの更新モード。ロールインスタンスは、サービスのデプロイ時に更新ドメインに割り当てられます。更新プログラムは、各更新ドメインで手動で開始することも、すべての更新ドメインで自動的に開始することもできます。使用可能な値は次のとおりです。

自動

手動

同時

指定しない場合、既定値は Auto です。[手動] に設定されている場合は、更新プログラムを適用するために PUT UpdateDomain を呼び出す必要があります。 [自動] に設定すると、更新プログラムは各更新ドメインに順番に自動的に適用されます。

値	説明
Auto
Manual
Simultaneous

CloudServiceVaultAndSecretReference

Object

拡張機能の保護された設定。ロールインスタンスに送信される前に暗号化された KeyVault を使用して参照されます。

名前	型	説明
secretUrl	string	拡張機能の保護された設定を含むシークレット URL
sourceVault	SubResource	Key Vault の ARM リソース ID

CloudServiceVaultCertificate

Object

Key Vault 内の 1 つの証明書参照と、証明書がロールインスタンスのどこに存在するかについて説明します。

名前	型	説明
certificateUrl	string	これは、シークレットとして Key Vault にアップロードされた証明書の URL です。
isBootstrapCertificate	boolean	指定された証明書が、残りの証明書をフェッチするために Key Vault 拡張機能によって使用されるブートストラップ証明書であるかどうかを示すフラグ。

CloudServiceVaultSecretGroup

Object

すべて同じ Key Vault 内にある証明書のセットについて説明します。

名前	型	説明
sourceVault	SubResource	VaultCertificates 内のすべての証明書を含む Key Vault の相対 URL。
vaultCertificates	CloudServiceVaultCertificate[]	証明書を含む SourceVault 内のキーコンテナー参照の一覧。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

Extension

Object

クラウドサービス拡張機能について説明します。

名前	型	説明
name	string	拡張機能の名前。
properties	CloudServiceExtensionProperties	拡張機能のプロパティ。

InnerError

Object

内部エラーの詳細。

名前	型	説明
errordetail	string	内部エラー・メッセージまたは例外ダンプ。
exceptiontype	string	例外タイプ。

LoadBalancerConfiguration

Object

ロード・バランサの構成について説明します。

名前	型	説明
id	string	リソース ID
name	string	ロードバランサーの名前
properties	LoadBalancerConfigurationProperties	ロードバランサー構成のプロパティ。

LoadBalancerConfigurationProperties

Object

ロード・バランサ構成のプロパティについて説明します。

名前	型	説明
frontendIpConfigurations	LoadBalancerFrontendIpConfiguration[]	ロードバランサーに使用するフロントエンド IP を指定します。 IPv4 フロントエンド IP アドレスのみがサポートされています。各ロードバランサー構成には、フロントエンド IP 構成が 1 つだけ必要です。

LoadBalancerFrontendIpConfiguration

Object

ロードバランサーに使用するフロントエンド IP を指定します。 IPv4 フロントエンド IP アドレスのみがサポートされています。各ロードバランサー構成には、フロントエンド IP 構成が 1 つだけ必要です。

名前	型	説明
name	string	ロードバランサーによって使用されるフロントエンド IP 構成のセット内で一意であるリソースの名前。この名前は、リソースへのアクセスに使用できます。
properties	LoadBalancerFrontendIpConfigurationProperties	ロードバランサーのフロントエンド IP 構成のプロパティ。

LoadBalancerFrontendIpConfigurationProperties

Object

クラウドサービスの IP 構成について説明します

名前	型	説明
privateIPAddress	string	IP 構成の仮想ネットワークプライベート IP アドレス。
publicIPAddress	SubResource	パブリック IP アドレスリソースへの参照。
subnet	SubResource	仮想ネットワークサブネットリソースへの参照。

SubResource

Object

名前	型	説明
id	string	リソース ID

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Cloud Services - Get

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

Get Cloud Service with Multiple Roles and RDP Extension

要求のサンプル

応答のサンプル

定義

ApiError

ApiErrorBase

CloudError

CloudService

CloudServiceExtensionProfile

CloudServiceExtensionProperties

CloudServiceNetworkProfile

CloudServiceOsProfile

CloudServiceProperties

CloudServiceRoleProfile

CloudServiceRoleProfileProperties

CloudServiceRoleSku

CloudServiceSlotType

CloudServiceUpgradeMode

CloudServiceVaultAndSecretReference

CloudServiceVaultCertificate

CloudServiceVaultSecretGroup

createdByType

Extension

InnerError

LoadBalancerConfiguration

LoadBalancerConfigurationProperties

LoadBalancerFrontendIpConfiguration

LoadBalancerFrontendIpConfigurationProperties

SubResource

systemData