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


Extensions - Update

A HCI-fürt bővítményének frissítése.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/arcSettings/{arcSettingName}/extensions/{extensionName}?api-version=2024-04-01

URI-paraméterek

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

string

A HCI ArcSetting információit tartalmazó proxyerőforrás neve.

clusterName
path True

string

A fürt neve.

extensionName
path True

string

A gép bővítményének neve.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
path True

string

minLength: 1

A cél-előfizetés azonosítója.

api-version
query True

string

minLength: 1

A művelethez használni kívánt API-verzió.

Kérelem törzse

Name Típus Description
properties.extensionParameters

ExtensionPatchParameters

A frissíthető gépbővítmények tulajdonságait ismerteti.

Válaszok

Name Típus Description
200 OK

Extension

OKÉ

202 Accepted

Elfogadott

Other Status Codes

ErrorResponse

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

Update Arc Extension

Mintakérelem

PATCH https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/clusters/myCluster/arcSettings/default/extensions/MicrosoftMonitoringAgent?api-version=2024-04-01

{
  "properties": {
    "extensionParameters": {
      "typeHandlerVersion": "1.10",
      "enableAutomaticUpgrade": false,
      "settings": {
        "workspaceId": "xx"
      },
      "protectedSettings": {
        "workspaceKey": "xx"
      }
    }
  }
}

Mintaválasz

{
  "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/clusters/myCluster/arcSettings/default/extensions/MicrosoftMonitoringAgent",
  "name": "MicrosoftMonitoringAgent",
  "type": "Microsoft.AzureStackHCI/clusters/arcSettings/extensions",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "extensionParameters": {
      "publisher": "Microsoft.Compute",
      "type": "string",
      "typeHandlerVersion": "1.10",
      "enableAutomaticUpgrade": false,
      "autoUpgradeMinorVersion": false,
      "settings": {
        "workspaceId": "xx"
      }
    },
    "aggregateState": "PartiallyConnected",
    "perNodeExtensionDetails": [
      {
        "name": "Node-1",
        "extension": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/ArcInstance-rg/providers/Microsoft.HybridCompute/machines/Node-1/Extensions/MicrosoftMonitoringAgent",
        "state": "Connected",
        "typeHandlerVersion": "1.10.0",
        "instanceView": {
          "name": "MicrosoftMonitoringAgent",
          "type": "MicrosoftMonitoringAgent",
          "typeHandlerVersion": "1.10.0",
          "status": {
            "code": "success",
            "level": "Information",
            "displayStatus": "Provisioning succeeded",
            "message": "Finished executing command, StdOut: , StdErr:",
            "time": "2019-08-08T20:42:10.999Z"
          }
        }
      },
      {
        "name": "Node-2",
        "extension": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/ArcInstance-rg/providers/Microsoft.HybridCompute/machines/Node-2/Extensions/MicrosoftMonitoringAgent",
        "state": "Disconnected",
        "typeHandlerVersion": "1.10.3",
        "instanceView": {
          "name": "MicrosoftMonitoringAgent",
          "type": "MicrosoftMonitoringAgent",
          "typeHandlerVersion": "1.10.3",
          "status": {
            "code": "error",
            "level": "Error",
            "displayStatus": "Provisioning failed",
            "message": "Finished executing command, StdOut: , StdErr:",
            "time": "2019-08-08T20:42:10.999Z"
          }
        }
      }
    ],
    "managedBy": "User"
  }
}
location: https://foo.com/operationStatuses

Definíciók

Name Description
createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

Extension

A HCI-fürt egy adott bővítményének részletei.

ExtensionAggregateState

Az Arc-bővítmények összesített állapota a HCI-fürt csomópontjai között.

ExtensionInstanceView

A bővítménypéldány nézetet ismerteti.

ExtensionManagedBy

Azt jelzi, hogy a bővítményt az Azure vagy a felhasználó kezeli-e.

ExtensionPatch

Frissítendő bővítmény részletei

ExtensionPatchParameters

A frissíthető gépbővítmények tulajdonságait ismerteti.

NodeExtensionState

Az Arc-bővítmény állapota ebben a csomópontban.

PerNodeExtensionState

A HCI-fürt egy adott csomópontjához tartozó Arc-bővítmény állapota.

ProvisioningState

A bővítményproxy-erőforrás kiépítési állapota.

Status

Példánynézet állapota.

StatusLevelTypes

A szintkód.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

Extension

A HCI-fürt egy adott bővítményének részletei.

Name Típus Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Az erőforrás neve

properties.aggregateState

ExtensionAggregateState

Az Arc-bővítmények összesített állapota a HCI-fürt csomópontjai között.

properties.extensionParameters.autoUpgradeMinorVersion

boolean

Azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.

properties.extensionParameters.enableAutomaticUpgrade

boolean

Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha újabb verzió érhető el.

properties.extensionParameters.forceUpdateTag

string

Hogyan kell a bővítménykezelőt frissíteni, még akkor is, ha a bővítménykonfiguráció nem változott.

properties.extensionParameters.protectedSettings

object

Védett beállítások (titkos kódokat tartalmazhatnak).

properties.extensionParameters.publisher

string

A bővítménykezelő közzétevőjének neve.

properties.extensionParameters.settings

object

Json formátumú nyilvános beállítások a bővítményhez.

properties.extensionParameters.type

string

Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".

properties.extensionParameters.typeHandlerVersion

string

A szkriptkezelő verzióját adja meg. Ha nincs megadva, a legújabb verzió lesz használva.

properties.managedBy

ExtensionManagedBy

Azt jelzi, hogy a bővítményt az Azure vagy a felhasználó kezeli-e.

properties.perNodeExtensionDetails

PerNodeExtensionState[]

Az Arc-bővítmény állapota az egyes csomópontokban.

properties.provisioningState

ProvisioningState

A bővítményproxy-erőforrás kiépítési állapota.

systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

ExtensionAggregateState

Az Arc-bővítmények összesített állapota a HCI-fürt csomópontjai között.

Érték Description
Accepted
Canceled
Connected
Creating
Deleted
Deleting
Disconnected
Error
Failed
InProgress
Moving
NotSpecified
PartiallyConnected
PartiallySucceeded
Provisioning
Succeeded
Updating
UpgradeFailedRollbackSucceeded

ExtensionInstanceView

A bővítménypéldány nézetet ismerteti.

Name Típus Description
name

string

A bővítmény neve.

status

Status

Példánynézet állapota.

type

string

Megadja a bővítmény típusát; Ilyen például a "MicrosoftMonitoringAgent".

typeHandlerVersion

string

A szkriptkezelő verzióját adja meg.

ExtensionManagedBy

Azt jelzi, hogy a bővítményt az Azure vagy a felhasználó kezeli-e.

Érték Description
Azure
User

ExtensionPatch

Frissítendő bővítmény részletei

Name Típus Description
properties.extensionParameters

ExtensionPatchParameters

A frissíthető gépbővítmények tulajdonságait ismerteti.

ExtensionPatchParameters

A frissíthető gépbővítmények tulajdonságait ismerteti.

Name Típus Description
enableAutomaticUpgrade

boolean

Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha újabb verzió érhető el.

protectedSettings

object

Védett beállítások (titkos kódokat tartalmazhatnak).

settings

object

Json formátumú nyilvános beállítások a bővítményhez.

typeHandlerVersion

string

A szkriptkezelő verzióját adja meg. Ha nincs megadva, a legújabb verzió lesz használva.

NodeExtensionState

Az Arc-bővítmény állapota ebben a csomópontban.

Érték Description
Accepted
Canceled
Connected
Creating
Deleted
Deleting
Disconnected
Error
Failed
InProgress
Moving
NotSpecified
PartiallyConnected
PartiallySucceeded
Provisioning
Succeeded
Updating

PerNodeExtensionState

A HCI-fürt egy adott csomópontjához tartozó Arc-bővítmény állapota.

Name Típus Description
extension

string

A csomópont adott Arc-bővítményének teljes erőforrás-azonosítója.

instanceView

ExtensionInstanceView

A bővítménypéldány nézete.

name

string

A HCI-fürt csomópontjának neve.

state

NodeExtensionState

Az Arc-bővítmény állapota ebben a csomópontban.

typeHandlerVersion

string

A szkriptkezelő verzióját adja meg.

ProvisioningState

A bővítményproxy-erőforrás kiépítési állapota.

Érték Description
Accepted
Canceled
Connected
Creating
Deleted
Deleting
Disconnected
Error
Failed
InProgress
Moving
NotSpecified
PartiallyConnected
PartiallySucceeded
Provisioning
Succeeded
Updating

Status

Példánynézet állapota.

Name Típus Description
code

string

Az állapotkód.

displayStatus

string

Az állapot rövid honosítható címkéje.

level

StatusLevelTypes

A szintkód.

message

string

A részletes állapotüzenet, beleértve a riasztásokat és a hibaüzeneteket is.

time

string (date-time)

Az állapot időpontja.

StatusLevelTypes

A szintkód.

Érték Description
Error
Info
Warning

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.