Cloud Services - List

리소스 그룹 아래의 모든 클라우드 서비스 목록을 가져옵니다. 응답에서 nextLink 속성을 사용하여 Cloud Services 다음 페이지를 가져옵니다. nextLink가 null이 될 때까지 이 작업을 수행하여 모든 Cloud Services 가져옵니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

리소스 그룹의 이름입니다.

subscriptionId
path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

api-version
query True

string

클라이언트 API 버전.

응답

Name 형식 Description
200 OK

CloudServiceListResult

정상

Other Status Codes

CloudError

오류

보안

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

List Cloud Services in a Resource Group

Sample Request

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

Sample Response

{
  "value": [
    {
      "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"
      }
    }
  ]
}

정의

Name Description
ApiError

API 오류입니다.

ApiErrorBase

API 오류 기준입니다.

CloudError

Compute 서비스의 오류 응답입니다.

CloudService

클라우드 서비스에 대해 설명합니다.

CloudServiceExtensionProfile

클라우드 서비스 확장 프로필에 대해 설명합니다.

CloudServiceExtensionProperties

확장 속성입니다.

CloudServiceListResult

목록 작업 결과입니다.

CloudServiceNetworkProfile

클라우드 서비스에 대한 네트워크 프로필입니다.

CloudServiceOsProfile

클라우드 서비스의 OS 프로필에 대해 설명합니다.

CloudServiceProperties

클라우드 서비스 속성

CloudServiceRoleProfile

클라우드 서비스의 역할 프로필을 설명합니다.

CloudServiceRoleProfileProperties

역할 속성을 설명합니다.

CloudServiceRoleSku

클라우드 서비스 역할 sku에 대해 설명합니다.

CloudServiceSlotType

클라우드 서비스의 슬롯 유형입니다. 가능한 값은 아래와 같습니다.

프로덕션

준비

지정하지 않으면 기본값은 Production입니다.

CloudServiceUpgradeMode

클라우드 서비스에 대한 업데이트 모드입니다. 서비스가 배포될 때 업데이트 도메인에 역할 인스턴스가 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작되거나 모든 업데이트 도메인에서 자동으로 시작될 수 있습니다. 가능한 값은 다음과 같습니다.

자동

수동

동시

지정하지 않으면 기본값은 Auto입니다. 수동으로 설정된 경우 업데이트를 적용하려면 PUT UpdateDomain을 호출해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.

CloudServiceVaultAndSecretReference

확장에 대한 보호된 설정으로, 역할 instance 전송되기 전에 암호화된 KeyVault를 사용하여 참조됩니다.

CloudServiceVaultCertificate

Key Vault 단일 인증서 참조와 인증서가 역할 instance 상주해야 하는 위치에 대해 설명합니다.

CloudServiceVaultSecretGroup

모두 동일한 Key Vault 있는 인증서 집합에 대해 설명합니다.

Extension

클라우드 서비스 확장을 설명합니다.

InnerError

내부 오류 세부 정보입니다.

LoadBalancerConfiguration

부하 분산 장치 구성에 대해 설명합니다.

LoadBalancerConfigurationProperties

부하 분산 장치 구성의 속성을 설명합니다.

LoadBalancerFrontendIpConfiguration

부하 분산 장치에 사용할 프런트 엔드 IP를 지정합니다. IPv4 프런트 엔드 IP 주소만 지원됩니다. 각 부하 분산 장치 구성에는 정확히 하나의 프런트 엔드 IP 구성이 있어야 합니다.

LoadBalancerFrontendIpConfigurationProperties

클라우드 서비스 IP 구성에 대해 설명합니다.

SubResource
SystemData

이 리소스와 관련된 시스템 메타 데이터입니다.

ApiError

API 오류입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

ApiErrorBase[]

API 오류 세부 정보

innererror

InnerError

API 내부 오류

message

string

오류 메시지입니다.

target

string

특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name 형식 Description
code

string

오류 코드입니다.

message

string

오류 메시지입니다.

target

string

특정 오류의 대상입니다.

CloudError

Compute 서비스의 오류 응답입니다.

Name 형식 Description
error

ApiError

API 오류입니다.

CloudService

클라우드 서비스에 대해 설명합니다.

Name 형식 Description
id

string

리소스 ID입니다.

location

string

리소스 위치.

name

string

리소스 이름입니다.

properties

CloudServiceProperties

클라우드 서비스 속성

systemData

SystemData

이 리소스와 관련된 시스템 메타 데이터입니다.

tags

object

리소스 태그.

type

string

리소스 종류.

zones

string[]

리소스의 논리적 가용성 영역 목록입니다. 목록에는 클라우드 서비스를 프로비전해야 하는 영역이 1개만 포함되어야 합니다. 이 필드는 선택 사항입니다.

CloudServiceExtensionProfile

클라우드 서비스 확장 프로필에 대해 설명합니다.

Name 형식 Description
extensions

Extension[]

클라우드 서비스에 대한 확장 목록입니다.

CloudServiceExtensionProperties

확장 속성입니다.

Name 형식 Description
autoUpgradeMinorVersion

boolean

플랫폼이 사용 가능해질 때 typeHandlerVersion을 상위 부 버전으로 자동으로 업그레이드할 수 있는지 여부를 명시적으로 지정합니다.

forceUpdateTag

string

태그를 지정하여 제공된 공용 및 보호된 설정을 강제로 적용합니다. 태그 값을 변경하면 퍼블릭 또는 보호된 설정을 변경하지 않고 확장을 다시 실행할 수 있습니다. forceUpdateTag가 변경되지 않으면 처리기에서 공용 또는 보호된 설정에 대한 업데이트가 계속 적용됩니다. forceUpdateTag 또는 public 또는 protected 설정이 모두 변경되지 않으면 확장은 동일한 시퀀스 번호로 instance 역할로 이동하며 다시 실행할지 여부를 처리기 구현해야 합니다.

protectedSettings

object

역할 instance 보내기 전에 암호화된 확장에 대한 보호된 설정입니다.

protectedSettingsFromKeyVault

CloudServiceVaultAndSecretReference

확장에 대한 보호된 설정으로, 역할 instance 전송되기 전에 암호화된 KeyVault를 사용하여 참조됩니다.

provisioningState

string

응답에만 표시되는 프로비전 상태입니다.

publisher

string

확장 처리기 게시자의 이름입니다.

rolesAppliedTo

string[]

이 확장을 적용할 역할의 선택적 목록입니다. 속성을 지정하지 않거나 '*'를 지정하면 클라우드 서비스의 모든 역할에 확장이 적용됩니다.

settings

object

확장에 대한 공용 설정입니다. JSON 확장의 경우 확장에 대한 JSON 설정입니다. XML 확장(예: RDP)의 경우 확장에 대한 XML 설정입니다.

type

string

확장의 유형을 지정합니다.

typeHandlerVersion

string

확장의 버전을 지정합니다. 확장의 버전을 지정합니다. 이 요소를 지정하지 않았거나 별표(*)를 값으로 사용하는 경우 최신 버전의 확장이 사용됩니다. 값이 주 버전 번호로 지정되고 별표가 부 버전 번호(X.)로 지정된 경우 지정된 주 버전의 최신 부 버전이 선택됩니다. 주 버전 번호와 부 버전 번호(X.Y)를 지정하면 특정 확장 버전이 선택됩니다. 버전을 지정하면 역할 인스턴스에서 자동 업그레이드가 수행됩니다.

CloudServiceListResult

목록 작업 결과입니다.

Name 형식 Description
nextLink

string

리소스의 다음 페이지를 가져올 URI입니다. 리소스의 다음 페이지를 가져오는 데 사용합니다. nextLink가 null이 될 때까지 이 작업을 수행하여 모든 리소스를 가져옵니다.

value

CloudService[]

리소스 목록입니다.

CloudServiceNetworkProfile

클라우드 서비스에 대한 네트워크 프로필입니다.

Name 형식 Description
loadBalancerConfigurations

LoadBalancerConfiguration[]

부하 분산 장치 구성 목록입니다. 클라우드 서비스에는 퍼블릭 Load Balancer 및 내부 Load Balancer 해당하는 최대 2개의 부하 분산 장치 구성이 있을 수 있습니다.

slotType

CloudServiceSlotType

클라우드 서비스의 슬롯 유형입니다. 가능한 값은 아래와 같습니다.

프로덕션

준비

지정하지 않으면 기본값은 Production입니다.

swappableCloudService

SubResource

주체 클라우드 서비스가 교환을 수행할 수 있는 대상 IP를 포함하는 클라우드 서비스의 ID 참조입니다. 이 속성은 설정되면 업데이트할 수 없습니다. 이 ID에서 참조하는 교환 가능한 클라우드 서비스가 있어야 합니다. 그렇지 않으면 오류가 throw됩니다.

CloudServiceOsProfile

클라우드 서비스의 OS 프로필에 대해 설명합니다.

Name 형식 Description
secrets

CloudServiceVaultSecretGroup[]

역할 인스턴스에 설치해야 하는 인증서 집합을 지정합니다.

CloudServiceProperties

클라우드 서비스 속성

Name 형식 Description
allowModelOverride

boolean

(선택 사항) 모델/템플릿에 지정된 역할 sku 속성(roleProfile.roles.sku)이 각각 .cscfg 및 .csdef에 지정된 역할 instance 개수 및 vm 크기를 재정의해야 하는지 여부를 나타냅니다. 기본값은 false입니다.

configuration

string

클라우드 서비스에 대한 XML 서비스 구성(.cscfg)을 지정합니다.

configurationUrl

string

Blob 서비스에서 서비스 구성의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다. 이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.

extensionProfile

CloudServiceExtensionProfile

클라우드 서비스 확장 프로필에 대해 설명합니다.

networkProfile

CloudServiceNetworkProfile

클라우드 서비스에 대한 네트워크 프로필입니다.

osProfile

CloudServiceOsProfile

클라우드 서비스의 OS 프로필에 대해 설명합니다.

packageUrl

string

Blob 서비스에서 서비스 패키지의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다. 이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.

provisioningState

string

응답에만 표시되는 프로비전 상태입니다.

roleProfile

CloudServiceRoleProfile

클라우드 서비스의 역할 프로필을 설명합니다.

startCloudService

boolean

(선택 사항) 클라우드 서비스를 만든 직후에 시작할지 여부를 나타냅니다. 기본값은 true입니다. false이면 서비스 모델이 계속 배포되지만 코드가 즉시 실행되지는 않습니다. 대신 서비스를 시작할 때 Start를 호출할 때까지 서비스는 PoweredOff입니다. 배포된 서비스는 전원이 공급되더라도 여전히 요금이 부과됩니다.

uniqueId

string

클라우드 서비스의 고유 식별자입니다.

upgradeMode

CloudServiceUpgradeMode

클라우드 서비스에 대한 업데이트 모드입니다. 서비스가 배포될 때 업데이트 도메인에 역할 인스턴스가 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작되거나 모든 업데이트 도메인에서 자동으로 시작될 수 있습니다. 가능한 값은 다음과 같습니다.

자동

수동

동시

지정하지 않으면 기본값은 Auto입니다. 수동으로 설정된 경우 업데이트를 적용하려면 PUT UpdateDomain을 호출해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.

CloudServiceRoleProfile

클라우드 서비스의 역할 프로필을 설명합니다.

Name 형식 Description
roles

CloudServiceRoleProfileProperties[]

클라우드 서비스에 대한 역할 목록입니다.

CloudServiceRoleProfileProperties

역할 속성을 설명합니다.

Name 형식 Description
name

string

리소스 이름입니다.

sku

CloudServiceRoleSku

클라우드 서비스 역할 sku에 대해 설명합니다.

CloudServiceRoleSku

클라우드 서비스 역할 sku에 대해 설명합니다.

Name 형식 Description
capacity

integer

클라우드 서비스의 역할 인스턴스 수를 지정합니다.

name

string

sku 이름입니다. 참고: 클라우드 서비스가 현재 있는 하드웨어에서 새 SKU가 지원되지 않는 경우 클라우드 서비스를 삭제하고 다시 만들거나 이전 sku로 다시 이동해야 합니다.

tier

string

클라우드 서비스의 계층을 지정합니다. 가능한 값은 다음과 같습니다.

Standard

기본

CloudServiceSlotType

클라우드 서비스의 슬롯 유형입니다. 가능한 값은 아래와 같습니다.

프로덕션

준비

지정하지 않으면 기본값은 Production입니다.

Name 형식 Description
Production

string

Staging

string

CloudServiceUpgradeMode

클라우드 서비스에 대한 업데이트 모드입니다. 서비스가 배포될 때 업데이트 도메인에 역할 인스턴스가 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작되거나 모든 업데이트 도메인에서 자동으로 시작될 수 있습니다. 가능한 값은 다음과 같습니다.

자동

수동

동시

지정하지 않으면 기본값은 Auto입니다. 수동으로 설정된 경우 업데이트를 적용하려면 PUT UpdateDomain을 호출해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.

Name 형식 Description
Auto

string

Manual

string

Simultaneous

string

CloudServiceVaultAndSecretReference

확장에 대한 보호된 설정으로, 역할 instance 전송되기 전에 암호화된 KeyVault를 사용하여 참조됩니다.

Name 형식 Description
secretUrl

string

확장의 보호된 설정을 포함하는 비밀 URL

sourceVault

SubResource

Key Vault ARM 리소스 ID

CloudServiceVaultCertificate

Key Vault 단일 인증서 참조와 인증서가 역할 instance 상주해야 하는 위치에 대해 설명합니다.

Name 형식 Description
certificateUrl

string

비밀로 Key Vault 업로드된 인증서의 URL입니다.

CloudServiceVaultSecretGroup

모두 동일한 Key Vault 있는 인증서 집합에 대해 설명합니다.

Name 형식 Description
sourceVault

SubResource

VaultCertificates의 모든 인증서를 포함하는 Key Vault 상대 URL입니다.

vaultCertificates

CloudServiceVaultCertificate[]

인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다.

Extension

클라우드 서비스 확장을 설명합니다.

Name 형식 Description
name

string

확장 프로그램의 이름입니다.

properties

CloudServiceExtensionProperties

확장 속성입니다.

InnerError

내부 오류 세부 정보입니다.

Name 형식 Description
errordetail

string

내부 오류 메시지 또는 예외 덤프입니다.

exceptiontype

string

예외 형식입니다.

LoadBalancerConfiguration

부하 분산 장치 구성에 대해 설명합니다.

Name 형식 Description
id

string

리소스 ID

name

string

부하 분산 장치의 이름

properties

LoadBalancerConfigurationProperties

부하 분산 장치 구성의 속성입니다.

LoadBalancerConfigurationProperties

부하 분산 장치 구성의 속성을 설명합니다.

Name 형식 Description
frontendIpConfigurations

LoadBalancerFrontendIpConfiguration[]

부하 분산 장치에 사용할 프런트 엔드 IP를 지정합니다. IPv4 프런트 엔드 IP 주소만 지원됩니다. 각 부하 분산 장치 구성에는 정확히 하나의 프런트 엔드 IP 구성이 있어야 합니다.

LoadBalancerFrontendIpConfiguration

부하 분산 장치에 사용할 프런트 엔드 IP를 지정합니다. IPv4 프런트 엔드 IP 주소만 지원됩니다. 각 부하 분산 장치 구성에는 정확히 하나의 프런트 엔드 IP 구성이 있어야 합니다.

Name 형식 Description
name

string

부하 분산 장치에서 사용하는 프런트 엔드 IP 구성 집합 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.

properties

LoadBalancerFrontendIpConfigurationProperties

부하 분산 장치 프런트 엔드 IP 구성의 속성입니다.

LoadBalancerFrontendIpConfigurationProperties

클라우드 서비스 IP 구성에 대해 설명합니다.

Name 형식 Description
privateIPAddress

string

IP 구성의 가상 네트워크 개인 IP 주소입니다.

publicIPAddress

SubResource

공용 IP 주소 리소스에 대한 참조입니다.

subnet

SubResource

가상 네트워크 서브넷 리소스에 대한 참조입니다.

SubResource

Name 형식 Description
id

string

리소스 ID

SystemData

이 리소스와 관련된 시스템 메타 데이터입니다.

Name 형식 Description
createdAt

string

클라우드 서비스(추가 지원) 리소스가 만들어진 시간을 UTC로 지정합니다.
최소 api-version: 2022-04-04.

lastModifiedAt

string

클라우드 서비스(추가 지원) 리소스가 마지막으로 수정된 시간을 UTC로 지정합니다.
최소 api-version: 2022-04-04.