다음을 통해 공유


Shared Gallery Image Versions - List

구독 ID 또는 테넌트 ID별로 공유 갤러리 이미지 버전을 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}/versions?api-version=2023-07-03
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}/versions?api-version=2023-07-03&sharedTo=tenant

URI 매개 변수

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

string

이미지 버전을 나열할 공유 갤러리 이미지 정의의 이름입니다.

galleryUniqueName
path True

string

공유 갤러리의 고유한 이름입니다.

location
path True

string

리소스 위치.

subscriptionId
path True

string

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

api-version
query True

string

클라이언트 API 버전.

sharedTo
query

SharedToValues

목록 작업을 수행할 때 가져올 공유 갤러리를 결정하는 쿼리 매개 변수입니다.

응답

Name 형식 Description
200 OK

SharedGalleryImageVersionList

정상

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName/versions?api-version=2023-07-03&sharedTo=tenant

샘플 응답

{
  "value": [
    {
      "properties": {
        "publishedDate": "2018-03-20T09:12:28Z",
        "endOfLifeDate": "2022-03-20T09:12:28Z",
        "excludeFromLatest": false,
        "storageProfile": {
          "osDiskImage": {
            "diskSizeGB": 29,
            "hostCaching": "None"
          }
        },
        "artifactTags": {
          "ShareTag-Official1PGallery": "Official1PGallery"
        }
      },
      "location": "myLocation",
      "name": "myGalleryImageVersionName",
      "identifier": {
        "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName/Versions/myGalleryImageVersionName"
      }
    }
  ],
  "nextLink": "http://svchost:99/subscriptions/{subscription-Id}/providers/Microsoft.Compute/sharedGalleries/galleryUniqueName/images/myGalleryImageName/versions?$skiptoken={token}/Subscriptions/{subscription-Id}/galleries/galleryUniqueName/images/myGalleryImageName/versions/myGalleryImageVersionName"
}

정의

Name Description
ApiError

API 오류입니다.

ApiErrorBase

API 오류 기준입니다.

CloudError

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

InnerError

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

SharedGalleryDataDiskImage

데이터 디스크 이미지입니다.

SharedGalleryHostCaching

디스크의 호스트 캐싱입니다. 유효한 값은 'None', 'ReadOnly' 및 'ReadWrite'입니다.

SharedGalleryImageVersion

만들거나 업데이트하려는 갤러리 이미지 버전에 대한 정보를 지정합니다.

SharedGalleryImageVersionList

공유 갤러리 이미지 나열 버전 작업 응답입니다.

SharedGalleryImageVersionStorageProfile

갤러리 이미지 버전의 스토리지 프로필입니다.

SharedGalleryOSDiskImage

OS 디스크 이미지입니다.

SharedToValues

목록 작업을 수행할 때 가져올 공유 갤러리를 결정하는 쿼리 매개 변수입니다.

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 오류입니다.

InnerError

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

Name 형식 Description
errordetail

string

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

exceptiontype

string

예외 형식입니다.

SharedGalleryDataDiskImage

데이터 디스크 이미지입니다.

Name 형식 Description
diskSizeGB

integer

이 속성은 만들 VHD의 크기를 나타냅니다.

hostCaching

SharedGalleryHostCaching

디스크의 호스트 캐싱입니다. 유효한 값은 'None', 'ReadOnly' 및 'ReadWrite'입니다.

lun

integer

이 속성은 데이터 디스크의 논리적 단위 번호를 지정합니다. 이 값은 Virtual Machine 내에서 데이터 디스크를 식별하는 데 사용되므로 Virtual Machine에 연결된 각 데이터 디스크에 대해 고유해야 합니다.

SharedGalleryHostCaching

디스크의 호스트 캐싱입니다. 유효한 값은 'None', 'ReadOnly' 및 'ReadWrite'입니다.

Name 형식 Description
None

string

ReadOnly

string

ReadWrite

string

SharedGalleryImageVersion

만들거나 업데이트하려는 갤러리 이미지 버전에 대한 정보를 지정합니다.

Name 형식 Description
identifier.uniqueId

string

이 공유 갤러리의 고유 ID입니다.

location

string

리소스 위치

name

string

리소스 이름

properties.artifactTags

object

공유 갤러리 리소스의 아티팩트 태그입니다.

properties.endOfLifeDate

string

갤러리 이미지 버전 정의의 수명 종료 날짜입니다. 이 속성은 서비스 해제 목적으로 사용할 수 있습니다. 이 속성은 업데이트할 수 있습니다.

properties.excludeFromLatest

boolean

true로 설정하면 최신 버전의 이미지 정의에서 배포된 Virtual Machines 이 이미지 버전을 사용하지 않습니다.

properties.publishedDate

string

갤러리 이미지 버전 정의의 게시된 날짜입니다. 이 속성은 서비스 해제 목적으로 사용할 수 있습니다. 이 속성은 업데이트할 수 있습니다.

properties.storageProfile

SharedGalleryImageVersionStorageProfile

이미지 버전의 스토리지 프로필을 설명합니다.

SharedGalleryImageVersionList

공유 갤러리 이미지 나열 버전 작업 응답입니다.

Name 형식 Description
nextLink

string

공유 갤러리 이미지 버전의 다음 페이지를 가져올 URI입니다. 이를 사용하여 ListNext()를 호출하여 공유 갤러리 이미지 버전의 다음 페이지를 가져옵니다.

value

SharedGalleryImageVersion[]

공유 갤러리 이미지 버전 목록입니다.

SharedGalleryImageVersionStorageProfile

갤러리 이미지 버전의 스토리지 프로필입니다.

Name 형식 Description
dataDiskImages

SharedGalleryDataDiskImage[]

데이터 디스크 이미지 목록입니다.

osDiskImage

SharedGalleryOSDiskImage

OS 디스크 이미지입니다.

SharedGalleryOSDiskImage

OS 디스크 이미지입니다.

Name 형식 Description
diskSizeGB

integer

이 속성은 만들 VHD의 크기를 나타냅니다.

hostCaching

SharedGalleryHostCaching

디스크의 호스트 캐싱입니다. 유효한 값은 'None', 'ReadOnly' 및 'ReadWrite'입니다.

SharedToValues

목록 작업을 수행할 때 가져올 공유 갤러리를 결정하는 쿼리 매개 변수입니다.

Name 형식 Description
tenant

string