Megosztás a következőn keresztül:


Galleries - Create Or Update

Megosztott képgyűjtemény létrehozása vagy frissítése.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}?api-version=2024-03-03

URI-paraméterek

Name In Kötelező Típus Description
galleryName
path True

string

A megosztott képtár neve. Az engedélyezett karakterek betűrendek és számok, középen pontokkal és pontokkal. A maximális hossz 80 karakter.

resourceGroupName
path True

string

Az erőforráscsoport neve.

subscriptionId
path True

string

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.

api-version
query True

string

Ügyfél API-verziója.

Kérelem törzse

Name Kötelező Típus Description
location True

string

Erőforrás helye

identity

GalleryIdentity

A katalógus identitása, ha konfigurálva van.

properties.description

string

A Megosztott képtár erőforrás leírása. Ez a tulajdonság frissíthető.

properties.identifier

GalleryIdentifier

A gyűjtemény egyedi nevét ismerteti.

properties.sharingProfile

SharingProfile

Profil a katalógus előfizetéssel vagy bérlői szolgáltatással való megosztásához

properties.softDeletePolicy

SoftDeletePolicy

A gyűjtemény helyreállítható törlési szabályzatával kapcsolatos információkat tartalmaz.

tags

object

Erőforráscímkék

Válaszok

Name Típus Description
200 OK

Gallery

OKÉ

201 Created

Gallery

Létrehozott

202 Accepted

Gallery

Elfogadott

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

Create a community gallery.
Create or update a simple gallery with sharing profile.
Create or update a simple gallery with soft deletion enabled.
Create or update a simple gallery with system-assigned and user-assigned managed identities.
Create or update a simple gallery.

Create a community gallery.

Mintakérelem

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03

{
  "location": "West US",
  "properties": {
    "description": "This is the gallery description.",
    "sharingProfile": {
      "permissions": "Community",
      "communityGalleryInfo": {
        "publisherUri": "uri",
        "publisherContact": "pir@microsoft.com",
        "eula": "eula",
        "publicNamePrefix": "PirPublic"
      }
    }
  }
}

Mintaválasz

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "sharingProfile": {
      "permissions": "Community",
      "communityGalleryInfo": {
        "publisherUri": "uri",
        "publisherContact": "pir@microsoft.com",
        "eula": "eula",
        "publicNamePrefix": "PirPublic"
      }
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Creating",
    "sharingProfile": {
      "permissions": "Community",
      "communityGalleryInfo": {
        "publisherUri": "uri",
        "publisherContact": "pir@microsoft.com",
        "eula": "eula",
        "publicNamePrefix": "PirPublic"
      }
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "sharingProfile": {
      "permissions": "Community",
      "communityGalleryInfo": {
        "publisherUri": "uri",
        "publisherContact": "pir@microsoft.com",
        "eula": "eula",
        "publicNamePrefix": "PirPublic"
      }
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}

Mintakérelem

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03

{
  "location": "West US",
  "properties": {
    "description": "This is the gallery description.",
    "sharingProfile": {
      "permissions": "Groups"
    }
  }
}

Mintaválasz

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "sharingProfile": {
      "permissions": "Groups"
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Creating",
    "sharingProfile": {
      "permissions": "Groups"
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "sharingProfile": {
      "permissions": "Groups"
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}

Mintakérelem

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03

{
  "location": "West US",
  "properties": {
    "description": "This is the gallery description.",
    "softDeletePolicy": {
      "isSoftDeleteEnabled": true
    }
  }
}

Mintaválasz

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "softDeletePolicy": {
      "isSoftDeleteEnabled": true
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Creating",
    "softDeletePolicy": {
      "isSoftDeleteEnabled": true
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "softDeletePolicy": {
      "isSoftDeleteEnabled": true
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}

Mintakérelem

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03

{
  "location": "West US",
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
    }
  },
  "properties": {
    "description": "This is the gallery description."
  }
}

Mintaválasz

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "userAssignedIdentities": {
      "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
    }
  },
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "userAssignedIdentities": {
      "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
    }
  },
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Creating",
    "softDeletePolicy": {
      "isSoftDeleteEnabled": true
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "userAssignedIdentities": {
      "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
    }
  },
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating",
    "softDeletePolicy": {
      "isSoftDeleteEnabled": true
    }
  },
  "location": "West US",
  "name": "myGalleryName"
}

Create or update a simple gallery.

Mintakérelem

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03

{
  "location": "West US",
  "properties": {
    "description": "This is the gallery description."
  }
}

Mintaválasz

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Creating"
  },
  "location": "West US",
  "name": "myGalleryName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery",
  "properties": {
    "description": "This is the gallery description.",
    "identifier": {
      "uniqueName": "{subscription-id}-MYGALLERYNAME"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryName"
}

Definíciók

Name Description
ApiError

Api-hiba.

ApiErrorBase

Api-hibabázis.

CloudError

Hibaválasz a Compute szolgáltatástól.

CommunityGalleryInfo

A közösségi galéria adatai, ha az aktuális katalógus meg van osztva a közösséggel

Gallery

Megadja a létrehozni vagy frissíteni kívánt megosztott képtár adatait.

GalleryIdentifier

A gyűjtemény egyedi nevét ismerteti.

GalleryIdentity

A virtuális gép identitása.

GalleryProvisioningState

A katalógus vagy katalógus összetevőjének aktuális állapota.

GallerySharingPermissionTypes

Ez a tulajdonság lehetővé teszi a megosztási gyűjtemény engedélyének megadását. Lehetséges értékek: Privát,Csoportok,Közösség.

InnerError

Belső hiba részletei.

RegionalSharingStatus

Katalógus regionális megosztási állapota

ResourceIdentityType

A katalógushoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az összes identitást a katalógusból.

SharingProfile

Profil a katalógus előfizetéssel vagy bérlői szolgáltatással való megosztásához

SharingProfileGroup

A katalógusmegosztási profil csoportja

SharingProfileGroupTypes

Ez a tulajdonság lehetővé teszi a megosztási csoport típusának megadását. Lehetséges értékek: Előfizetések,AADTenants.

SharingState

A katalógus megosztási állapota.

SharingStatus

Az aktuális katalógus megosztási állapota.

SoftDeletePolicy

A gyűjtemény helyreállítható törlési szabályzatával kapcsolatos információkat tartalmaz.

UserAssignedIdentities

A virtuális géphez társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ApiError

Api-hiba.

Name Típus Description
code

string

A hibakód.

details

ApiErrorBase[]

Az API-hiba részletei

innererror

InnerError

Az Api belső hibája

message

string

A hibaüzenet.

target

string

Az adott hiba célja.

ApiErrorBase

Api-hibabázis.

Name Típus Description
code

string

A hibakód.

message

string

A hibaüzenet.

target

string

Az adott hiba célja.

CloudError

Hibaválasz a Compute szolgáltatástól.

Name Típus Description
error

ApiError

Api-hiba.

CommunityGalleryInfo

A közösségi galéria adatai, ha az aktuális katalógus meg van osztva a közösséggel

Name Típus Description
communityGalleryEnabled

boolean

Információkat tartalmaz arról, hogy engedélyezve van-e a közösségi galéria megosztása.

eula

string

Végfelhasználói licencszerződés a közösségi galéria rendszerképéhez.

publicNamePrefix

string

A nyilvánosan megjelenítendő katalógusnév előtagja. Minden felhasználó számára látható.

publicNames

string[]

Közösségi galéria nyilvános névlistája.

publisherContact

string

A közösségi galéria közzétevője támogatja az e-maileket. A közzétevő e-mail-címe. Minden felhasználó számára látható.

publisherUri

string

A közzétevő webhelyére mutató hivatkozás. Minden felhasználó számára látható.

Megadja a létrehozni vagy frissíteni kívánt megosztott képtár adatait.

Name Típus Description
id

string

Erőforrás-azonosító

identity

GalleryIdentity

A katalógus identitása, ha konfigurálva van.

location

string

Erőforrás helye

name

string

Erőforrás neve

properties.description

string

A Megosztott képtár erőforrás leírása. Ez a tulajdonság frissíthető.

properties.identifier

GalleryIdentifier

A gyűjtemény egyedi nevét ismerteti.

properties.provisioningState

GalleryProvisioningState

A katalógus vagy katalógus összetevőjének aktuális állapota.
A kiépítési állapot, amely csak a válaszban jelenik meg.

properties.sharingProfile

SharingProfile

Profil a katalógus előfizetéssel vagy bérlői szolgáltatással való megosztásához

properties.sharingStatus

SharingStatus

Az aktuális katalógus megosztási állapota.

properties.softDeletePolicy

SoftDeletePolicy

A gyűjtemény helyreállítható törlési szabályzatával kapcsolatos információkat tartalmaz.

tags

object

Erőforráscímkék

type

string

Erőforrás típusa

GalleryIdentifier

A gyűjtemény egyedi nevét ismerteti.

Name Típus Description
uniqueName

string

A megosztott képgyűjtemény egyedi neve. Ezt a nevet az Azure automatikusan létrehozza.

GalleryIdentity

A virtuális gép identitása.

Name Típus Description
principalId

string

A katalógus identitásának fő azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.

tenantId

string

A katalógus-identitás AAD-bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.

type

ResourceIdentityType

A katalógushoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az összes identitást a katalógusból.

userAssignedIdentities

UserAssignedIdentities

A katalógushoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

GalleryProvisioningState

A katalógus vagy katalógus összetevőjének aktuális állapota.

Érték Description
Creating
Deleting
Failed
Migrating
Succeeded
Updating

GallerySharingPermissionTypes

Ez a tulajdonság lehetővé teszi a megosztási gyűjtemény engedélyének megadását. Lehetséges értékek: Privát,Csoportok,Közösség.

Érték Description
Community
Groups
Private

InnerError

Belső hiba részletei.

Name Típus Description
errordetail

string

A belső hibaüzenet vagy kivételkép.

exceptiontype

string

A kivétel típusa.

RegionalSharingStatus

Katalógus regionális megosztási állapota

Name Típus Description
details

string

A katalógus regionális megosztási hibájának részletei.

region

string

Régió neve

state

SharingState

A katalógus megosztási állapota.
Katalógusmegosztási állapot az aktuális régióban

ResourceIdentityType

A katalógushoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az összes identitást a katalógusból.

Érték Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

SharingProfile

Profil a katalógus előfizetéssel vagy bérlői szolgáltatással való megosztásához

Name Típus Description
communityGalleryInfo

CommunityGalleryInfo

A közösségi katalógus adatai, ha az aktuális katalógus meg van osztva a közösséggel.

groups

SharingProfileGroup[]

A megosztási profilcsoportok listája.

permissions

GallerySharingPermissionTypes

Ez a tulajdonság lehetővé teszi a megosztási gyűjtemény engedélyének megadását. Lehetséges értékek: Privát,Csoportok,Közösség.

SharingProfileGroup

A katalógusmegosztási profil csoportja

Name Típus Description
ids

string[]

A katalógushoz tartozó előfizetés-/bérlőazonosítók listáját meg szeretné osztani.

type

SharingProfileGroupTypes

Ez a tulajdonság lehetővé teszi a megosztási csoport típusának megadását. Lehetséges értékek: Előfizetések,AADTenants.

SharingProfileGroupTypes

Ez a tulajdonság lehetővé teszi a megosztási csoport típusának megadását. Lehetséges értékek: Előfizetések,AADTenants.

Érték Description
AADTenants
Subscriptions

SharingState

A katalógus megosztási állapota.

Érték Description
Failed
InProgress
Succeeded
Unknown

SharingStatus

Az aktuális katalógus megosztási állapota.

Name Típus Description
aggregatedState

SharingState

A katalógus megosztási állapota.
Az aktuális katalógus összesített megosztási állapota.

summary

RegionalSharingStatus[]

Az összes regionális megosztási állapot összegzése.

SoftDeletePolicy

A gyűjtemény helyreállítható törlési szabályzatával kapcsolatos információkat tartalmaz.

Name Típus Description
isSoftDeleteEnabled

boolean

Lehetővé teszi a gyűjteményben lévő erőforrások helyreállítható törlését, így azok megőrzési időn belül helyreállíthatók.

UserAssignedIdentities

A virtuális géphez társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name Típus Description