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-04-04

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

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

api-version
query True
  • string

클라이언트 API 버전입니다.

응답

Name Type Description
200 OK

정상

Other Status Codes

오류

보안

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-04-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"
      }
    }
  ]
}

정의

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

역할 인스턴스로 전송되기 전에 암호화된 KeyVault를 사용하여 참조되는 확장에 대한 보호된 설정입니다.

CloudServiceVaultCertificate

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

CloudServiceVaultSecretGroup

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

Extension

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

InnerError

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

LoadBalancerConfiguration

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

LoadBalancerConfigurationProperties

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

LoadBalancerFrontendIPConfiguration

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

LoadBalancerFrontendIPConfigurationProperties

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

SubResource
SystemData

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

ApiError

API 오류입니다.

Name Type Description
code
  • string

오류 코드입니다.

details

API 오류 세부 정보

innererror

API 내부 오류

message
  • string

오류 메시지입니다.

target
  • string

특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name Type Description
code
  • string

오류 코드입니다.

message
  • string

오류 메시지입니다.

target
  • string

특정 오류의 대상입니다.

CloudError

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

Name Type Description
error

API 오류입니다.

CloudService

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

Name Type Description
id
  • string

리소스 ID입니다.

location
  • string

리소스 위치.

name
  • string

리소스 이름입니다.

properties

클라우드 서비스 속성

systemData

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

tags
  • object

리소스 태그입니다.

type
  • string

리소스 종류.

CloudServiceExtensionProfile

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

Name Type Description
extensions

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

CloudServiceExtensionProperties

확장 속성입니다.

Name Type Description
autoUpgradeMinorVersion
  • boolean

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

forceUpdateTag
  • string

제공된 공용 및 보호된 설정을 강제로 적용하는 태그입니다. 태그 값을 변경하면 공용 또는 보호된 설정을 변경하지 않고 확장을 다시 실행할 수 있습니다. forceUpdateTag가 변경되지 않으면 공용 또는 보호된 설정에 대한 업데이트가 처리기에서 계속 적용됩니다. forceUpdateTag 또는 public 또는 protected 설정이 변경되지 않는 경우 확장은 동일한 시퀀스 번호를 사용하여 역할 인스턴스로 흐르며 다시 실행할지 여부는 처리기 구현에 달려 있습니다.

protectedSettings
  • object

역할 인스턴스로 전송되기 전에 암호화된 확장에 대한 보호된 설정입니다.

protectedSettingsFromKeyVault

역할 인스턴스로 전송되기 전에 암호화된 KeyVault를 사용하여 참조되는 확장에 대한 보호된 설정입니다.

provisioningState
  • string

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

publisher
  • string

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

rolesAppliedTo
  • string[]

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

settings
  • object

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

type
  • string

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

typeHandlerVersion
  • string

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

CloudServiceListResult

목록 작업 결과입니다.

Name Type Description
nextLink
  • string

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

value

리소스 목록입니다.

CloudServiceNetworkProfile

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

Name Type Description
loadBalancerConfigurations

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

slotType

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

프로덕션

준비

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

swappableCloudService

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

CloudServiceOsProfile

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

Name Type Description
secrets

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

CloudServiceProperties

클라우드 서비스 속성

Name Type Description
allowModelOverride
  • boolean

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

configuration
  • string

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

configurationUrl
  • string

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

extensionProfile

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

networkProfile

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

osProfile

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

packageUrl
  • string

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

provisioningState
  • string

응답에만 나타나는 프로비전 상태입니다.

roleProfile

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

startCloudService
  • boolean

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

uniqueId
  • string

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

upgradeMode

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

자동

수동

동시

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

CloudServiceRoleProfile

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

Name Type Description
roles

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

CloudServiceRoleProfileProperties

역할 속성을 설명합니다.

Name Type Description
name
  • string

리소스 이름입니다.

sku

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

CloudServiceRoleSku

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

Name Type Description
capacity
  • integer

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

name
  • string

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

tier
  • string

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

Standard

기본

CloudServiceSlotType

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

프로덕션

준비

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

Name Type Description
Production
  • string
Staging
  • string

CloudServiceUpgradeMode

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

자동

수동

동시

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

Name Type Description
Auto
  • string
Manual
  • string
Simultaneous
  • string

CloudServiceVaultAndSecretReference

역할 인스턴스로 전송되기 전에 암호화된 KeyVault를 사용하여 참조되는 확장에 대한 보호된 설정입니다.

Name Type Description
secretUrl
  • string

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

sourceVault

Key Vault ARM 리소스 ID

CloudServiceVaultCertificate

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

Name Type Description
certificateUrl
  • string

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

CloudServiceVaultSecretGroup

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

Name Type Description
sourceVault

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

vaultCertificates

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

Extension

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

Name Type Description
name
  • string

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

properties

확장 속성입니다.

InnerError

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

Name Type Description
errordetail
  • string

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

exceptiontype
  • string

예외 형식입니다.

LoadBalancerConfiguration

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

Name Type Description
id
  • string

리소스 ID

name
  • string

부하 분산 장치의 이름

properties

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

LoadBalancerConfigurationProperties

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

Name Type Description
frontendIPConfigurations

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

LoadBalancerFrontendIPConfiguration

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

Name Type Description
name
  • string

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

properties

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

LoadBalancerFrontendIPConfigurationProperties

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

Name Type Description
privateIPAddress
  • string

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

publicIPAddress

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

subnet

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

SubResource

Name Type Description
id
  • string

리소스 ID

SystemData

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

Name Type Description
createdAt
  • string

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

lastModifiedAt
  • string

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