내보내기(0) 인쇄
모두 확장

구독 작업 나열

업데이트 날짜: 2014년 5월

List Subscription Operations 작업은 지정된 기간 동안 구독에서 수행된 만들기, 업데이트 및 삭제 작업 목록을 반환합니다.

다음과 같이 List Subscription Operations 요청을 지정할 수 있습니다. <subscription-id>를 구독 ID로 바꾸십시오.

 

방법 요청 URI

GET

https://management.core.windows.net/<subscription-id>/operations

관리 서비스에 대한 요청이 안전한지 확인해야 합니다. 자세한 내용은 서비스 관리 요청 인증을 참조하십시오.

 

URI 매개 변수 설명

StartTime=<start-of-timeframe>

필수 사항입니다. 구독 작업을 UTC 형식으로 나열하는 작업을 시작하는 기간의 시작입니다. 이 매개 변수 및 EndTime 매개 변수는 구독 작업을 검색할 시간을 나타냅니다. 이 매개 변수는 이전 90일이 넘는 시작 날짜를 나타낼 수 없습니다.

이 매개 변수에 대한 시간을 지정하는 경우 시간 앞에 시간 요소의 시작을 나타내는 리터럴 문자열 "T"를 포함해야 합니다. 또한 시간 요소 뒤에 시간이 UTC 형식임을 나타내는 리터럴 문자열 "Z"를 포함해야 합니다. 예를 들어 시작 시간 2011년 3월 1일 오후 4시 30분은 다음과 같이 표현됩니다. StartTime=2011-03-01T16:30:00Z

다음 시간 형식을 사용할 수 있습니다.

  • StartTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]

    예: StartTime=2011-03-01

  • StartTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

    예: StartTime=2011-03-01T16:30:00Z

  • StartTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitMinute]:[2DigitSecond].[7DigitsOfPrecision]Z

    예: StartTime=2011-03-01T16:30:00.0005000Z

EndTime=<end-of-timeframe>

필수 사항입니다. 구독 작업을 UTC 형식으로 나열하는 작업을 시작하는 기간의 종료입니다. 이 매개 변수 및 StartTime 매개 변수는 구독 작업을 검색할 시간을 나타냅니다.

이 매개 변수에 대한 시간을 지정하는 경우 시간 앞에 시간 요소의 시작을 나타내는 리터럴 문자열 "T"를 포함해야 합니다. 또한 시간 요소 뒤에 시간이 UTC 형식임을 나타내는 리터럴 문자열 "Z"를 포함해야 합니다. 예를 들어 종료 시간 2011년 3월 7일 오후 4시 30분은 다음과 같이 표현됩니다. EndTime=2011-03-07T16:30:00Z

다음 시간 형식을 사용할 수 있습니다.

  • EndTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]

    예: EndTime=2011-03-07

  • EndTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

    예: EndTime=2011-03-07T16:30:00Z

  • EndTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitMinute]:[2DigitSecond].[7DigitsOfPrecision]Z

    예: EndTime=2011-03-07T16:30:00.0005000Z

ObjectIdFilter=<object-url>

선택적 요소입니다. 지정된 개체 유형 및 개체 ID에 대한 구독 작업만 반환합니다. 이 매개 변수는 개체에서 HTTP GET을 수행하기 위한 URL 값과 동일하게 설정해야 합니다. 개체가 지정되지 않은 경우 필터가 적용되지 않습니다. 적용 가능한 개체 유형 및 예제가 아래에 있습니다. <subscription-id>와 같은 샘플 값을 원하는 값으로 바꾸십시오.

 

개체 유형

필터의 개체 URL

구독

ObjectIdFilter=/<subscription-id>

클라우드 서비스

ObjectIdFilter=/<subscription-id>/services/hostedservices/<cloud-service-name>

저장소 서비스

ObjectIdFilter=/<subscription-id>/services/storageservices/<storage-service-name>

선호도 그룹

ObjectIdFilter=/<subscription-id>/affinitygroups/<affinity-group-name>

배포

ObjectIdFilter=/<subscription-id>/services/hostedservices/<cloud-service-name>/deployments/<deployment-name>

역할 인스턴스

ObjectIdFilter=/<subscription-id>/services/hostedservices/<cloud-service-name>/deployments/<deployment-name>/roleinstances/<role-instance-name>

컴퓨터 이미지

ObjectIdFilter=/<subscription-id>/machineimages/<machine-image-name>

OperationResultFilter=<Succeeded|Failed|InProgress>

선택적 요소입니다. 지정한 결과 상태인 Succeeded, Failed 또는 InProgress에 대한 구독 작업만 반환합니다. 이 필터는 ObjectIdFilter와 결합되어 특정 결과 상태인 개체에 대한 구독 작업을 선택할 수 있습니다. 결과 상태가 지정되지 않은 경우 필터가 적용되지 않습니다. 예를 들어 다음 요청 URI 조각은 저장소 서비스에 대해 성공적인 모든 작업을 반환합니다.

ObjectIdFilter=/<subscription-id>/services/storageservices/<storage-service-name>&OperationResultFilter=Succeeded

ContinuationToken=<opaque-continuation-token>

선택적 요소입니다. 요청된 기간이 너무 큰 경우와 같이 목록에 작업이 너무 많은 경우 응답에는 목록의 나머지를 반환하는 데 사용될 수 있는 불완전 목록 및 토큰이 포함되어 있습니다. 마지막 응답이 중단된 시점에서 계속 작업을 나열하도록 후속 요청에 이 매개 변수를 포함할 수 있습니다. 토큰이 지정되지 않은 경우 필터가 적용되지 않으며 지정된 StartTime에 응답이 시작됩니다.

다음 표에서는 요청 헤더에 대해 설명합니다.

 

요청 헤더 설명

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더는 2011-02-25 이후로 설정되어야 합니다. 버전 관리 헤더에 대한 자세한 내용은 서비스 관리 버전 관리를 참조하십시오.

없음.

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하십시오.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.

응답 본문의 형식은 다음과 같습니다.


<?xml version="1.0" encoding="utf-8"?>
<SubscriptionOperationCollection xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <SubscriptionOperations>
    <SubscriptionOperation>
      <OperationId>subscription-operation-id</OperationId>
      <OperationObjectId>subscription-object-id</OperationObjectId>
      <OperationName>subscription-operation-name</OperationName>
      <OperationParameters xmlns:a="http://schemas.datacontract.org/2004/07/Microsoft.Samples.WindowsAzure.ServiceManagement">
        <OperationParameter>
          <a:Name>operation-parameter-name</a:Name>
          <a:Value><?xml version="1.0" encoding="utf-16"?>
            <z:anyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:d1p1="http://schemas.microsoft.com/windowsazure" i:type="d1p1:<type-body>" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/">
              …xml body…
            </z:anyType>
          </a:Value>
        </OperationParameter>
      </OperationParameters>
      <OperationCaller>
        <UsedServiceManagementApi>true</UsedServiceManagementApi>
        <SubscriptionCertificateThumbprint>subscription-certificate-thumbprint</SubscriptionCertificateThumbprint>
        <ClientIP>client-ip-address</ClientIP>
      </OperationCaller>
      <OperationStatus>operation-status</OperationStatus>
      <OperationStartedTime>operation-start-time</OperationStartedTime>
      <OperationCompletedTime>operation-completed-time</OperationCompletedTime>
    </SubscriptionOperation>
  </SubscriptionOperations>
<ContinuationToken>continuation-token-value</ContinuationToken>
</SubscriptionOperationCollection>

다음 표에서는 응답 본문의 요소에 대해 설명합니다.

 

요소 이름 설명

SubscriptionOperations

지정된 기간 동안 구독에서 수행된 작업 목록을 지정합니다.

ContinuationToken

목록의 나머지를 반환하는 데 사용할 수 있는 문자열을 지정합니다. 마지막 응답이 중단된 시점에서 계속 작업을 나열하도록 후속 요청에 이 매개 변수를 포함할 수 있습니다. 이 요소는 구독 작업의 전체 목록이 반환되지 않은 경우에만 존재합니다.

SubscriptionOperation

지정된 기간 동안 구독에서 수행된 단일 작업을 지정합니다.

OperationID

작업의 GUID(Globally Unique Identifier)를 지정합니다.

OperationObjectID

작업에 대한 대상 개체를 지정합니다. 이 값은 개체에서 HTTP GET을 수행하는 URL과 동일하며 요청에서는 ObjectIdFilter와 동일한 값에 해당합니다.

OperationName

수행된 작업의 이름을 지정합니다. 가능한 값은 다음과 같습니다.

  • ActivateDomainName

  • AddCertificates

  • AddSubscriptionCertificate

  • ChangeDeploymentConfiguration

  • ChangeDeploymentConfigurationBySlot

  • CommitImageUpload

  • CreateAffinityGroup

  • CreateDeployment

  • CreateDeploymentBySlot

  • CreateHostedService

  • CreateStorageService

  • DeleteAffinityGroup

  • DeleteCertificate

  • DeleteDeployment

  • DeleteHostedService

  • DeleteImage

  • DeleteStorageService

  • PrepareImageUpload

  • RebootDeploymentRoleInstance

  • RebootDeploymentRoleInstanceBySlot

  • ReimageDeploymentRoleInstance

  • ReimageDeploymentRoleInstanceBySlot

  • RegenerateStorageServiceKeys

  • RegisterDomainName

  • RemoveSubscriptionCertificate

  • RollbackDeploymentUpdateOrUpgrade

  • SetImageProperties

  • SetParentImage

  • SwapDeployment

  • UnregisterDomainName

  • UpdateAffinityGroup

  • UpdateDeploymentStatus

  • UpdateDeploymentStatusBySlot

  • UpdateHostedService

  • UpdateStorageService

  • UpdateStorageService

  • UpgradeDeployment

  • UpgradeDeploymentBySlot

  • WalkUpgradeDomain

  • WalkUpgradeDomainBySlot

OperationParameters

수행된 작업에 대한 매개 변수 컬렉션을 지정합니다.

OperationParameter

수행된 작업에 대한 단일 매개 변수를 지정합니다.

Name

매개 변수의 이름을 지정합니다.

매개 변수의 값을 지정합니다. 값은 수행된 구독 작업에 따라 문자열 또는 XML 문서로 나타낼 수 있습니다.

OperationCaller

작업 원본을 식별하는 특성의 컬렉션을 지정합니다.

UsedServiceManagementApi

서비스 관리 API를 사용하여 작업을 시작했는지 여부를 나타냅니다. 작업이 관리 포털과 같은 다른 원본에 의해 시작된 경우 False입니다.

UserEmailAddress

관리 포털에서 작업을 시작한 사용자의 Windows Live ID와 연결된 전자 메일을 지정합니다. 이 요소는 UsedServiceManagementApifalse인 경우에만 반환됩니다.

ClientIP

작업을 시작한 클라이언트 컴퓨터의 IP 주소를 지정합니다. 이 요소는 UsedServiceManagementApitrue인 경우에만 반환됩니다.

SubscriptionCertificateThumbprint

작업을 시작하는 데 사용되는 구독 인증서의 지문을 지정합니다.

OperationStatus

작업의 현재 상태에 대한 정보를 포함하는 개체를 지정합니다. 반환된 개체의 XML 형식은 다음과 같습니다.

<OperationStatus><ID>339c6c13-1f81-412f-9bc6-00e9c5876695</ID><Status>Succeeded</Status><HttpStatusCode>200</HttpStatusCode></OperationStatus>

작업 상태를 보유하는 Status 요소의 가능한 값은 다음과 같습니다.

  • Succeeded

  • Failed

  • InProgress

OperationStartedTime

작업 실행이 시작된 시간을 지정합니다. 시간의 형식은 다음과 같습니다.

[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

예: 2011-05-11T16:15:26Z

note참고
OperationStartedTime 요소는 버전 2011-06-01 이상에서만 사용할 수 있습니다.

OperationCompletedTime

작업 실행이 완료된 시간을 지정합니다. 작업이 계속 진행 중인 경우 이 요소는 없는 것입니다. 시간의 형식은 다음과 같습니다.

[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

예: 2011-05-11T16:15:32Z

note참고
OperationCompletedTime 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft