Delen via


Update Order Item - Update Order Item

Hiermee worden de eigenschappen van een bestaand orderitem bijgewerkt.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EdgeOrder/orderItems/{orderItemName}?api-version=2021-12-01

URI-parameters

Name In Vereist Type Description
orderItemName
path True

string

De naam van het orderitem

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

subscriptionId
path True

string

minLength: 1

De id van het doelabonnement.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Name Vereist Type Description
If-Match

string

Hiermee definieert u de voorwaarde If-Match. De patch wordt alleen uitgevoerd als de ETag van de order op de server overeenkomt met deze waarde.

Aanvraagbody

Name Type Description
properties.forwardAddress

AddressProperties

Hiermee worden het verzendadres en contactgegevens bijgewerkt.

properties.notificationEmailList

string[]

Aanvullende lijst met e-mailmeldingen.

properties.preferences

Preferences

Klantvoorkeur.

tags

object

De lijst met sleutel-waardeparen die de resource beschrijven. Deze tags kunnen worden gebruikt voor het weergeven en groeperen van deze resource (tussen resourcegroepen).

Antwoorden

Name Type Description
200 OK

OrderItemResource

Resourceobject orderitem.

202 Accepted

Geaccepteerde aanvraag voor het bijwerken van orderitems.

Other Status Codes

ErrorResponse

Foutantwoord met een beschrijving van de reden voor een bewerkingsfout.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

UpdateOrderItem

Voorbeeldaanvraag

PATCH https://management.azure.com/subscriptions/YourSubscriptionId/resourceGroups/YourResourceGroupName/providers/Microsoft.EdgeOrder/orderItems/TestOrderItemName3?api-version=2021-12-01

{
  "properties": {
    "preferences": {
      "transportPreferences": {
        "preferredShipmentType": "CustomerManaged"
      }
    }
  }
}

Voorbeeldrespons

{
  "properties": {
    "orderItemDetails": {
      "productDetails": {
        "displayInfo": {
          "productFamilyDisplayName": "Azure Stack Edge",
          "configurationDisplayName": "Azure Stack Edge Pro - 1 GPU"
        },
        "hierarchyInformation": {
          "productFamilyName": "azurestackedge",
          "productLineName": "azurestackedge",
          "productName": "azurestackedgegpu",
          "configurationName": "edgep_base"
        },
        "count": 0,
        "productDoubleEncryptionStatus": "Disabled"
      },
      "orderItemType": "Purchase",
      "currentStage": {
        "stageStatus": "Succeeded",
        "stageName": "Placed",
        "startTime": "2022-03-04T11:30:31.5838042+05:30"
      },
      "orderItemStageHistory": [
        {
          "stageStatus": "Succeeded",
          "stageName": "Placed",
          "startTime": "2022-03-04T11:30:31.5838042+05:30"
        },
        {
          "stageStatus": "None",
          "stageName": "Confirmed"
        },
        {
          "stageStatus": "None",
          "stageName": "ReadyToShip"
        },
        {
          "stageStatus": "None",
          "stageName": "Shipped"
        },
        {
          "stageStatus": "None",
          "stageName": "Delivered"
        },
        {
          "stageStatus": "None",
          "stageName": "InUse"
        }
      ],
      "preferences": {
        "transportPreferences": {
          "preferredShipmentType": "CustomerManaged"
        }
      },
      "notificationEmailList": [],
      "cancellationStatus": "Cancellable",
      "deletionStatus": "NotAllowed",
      "returnStatus": "NotReturnable",
      "managementRpDetailsList": [
        {
          "resourceProviderNamespace": "Microsoft.DataBoxEdge"
        }
      ]
    },
    "addressDetails": {
      "forwardAddress": {
        "shippingAddress": {
          "streetAddress1": "16 TOWNSEND ST",
          "streetAddress2": "UNIT 1",
          "city": "San Francisco",
          "stateOrProvince": "CA",
          "country": "US",
          "postalCode": "94107",
          "companyName": "Microsoft",
          "addressType": "None"
        },
        "contactDetails": {
          "contactName": "XXXX XXXX",
          "phone": "0000000000",
          "phoneExtension": "",
          "emailList": [
            "xxxx@xxxx.xxx"
          ]
        },
        "addressValidationStatus": "Valid"
      }
    },
    "startTime": "2022-03-04T11:29:47.3483197+05:30",
    "orderId": "/subscriptions/YourSubscriptionId/resourceGroups/YourResourceGroupName/providers/Microsoft.EdgeOrder/locations/eastus/orders/TestOrderName3"
  },
  "systemData": {
    "createdAt": "0001-01-01T05:30:00+05:30",
    "lastModifiedAt": "0001-01-01T05:30:00+05:30"
  },
  "location": "eastus",
  "tags": {},
  "name": "TestOrderItemName3",
  "id": "/subscriptions/YourSubscriptionId/resourceGroups/YourResourceGroupName/providers/Microsoft.EdgeOrder/orderItems/TestOrderItemName3",
  "type": "Microsoft.EdgeOrder/orderItems"
}

Definities

Name Description
ActionStatusEnum

Beschrijft of het orderitem al dan niet kan worden verwijdert.

AddressDetails

Adresgegevens voor een orderitem.

AddressProperties

Adreseigenschappen

AddressType

Type adres.

AddressValidationStatus

Status van adresvalidatie

ContactDetails

Contactgegevens.

createdByType

Het type identiteit waarmee de resource is gemaakt.

DeviceDetails

Apparaatdetails.

DisplayInfo

Beschrijft productweergave-informatie

DoubleEncryptionStatus

Dubbele versleutelingsstatus zoals ingevoerd door de klant. Het is verplicht om deze parameter te geven als het beleid Weigeren of Uitgeschakeld is geconfigureerd.

EncryptionPreferences

Voorkeuren met betrekking tot dubbele versleuteling

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

ForwardShippingDetails

Verzendgegevens door.

HierarchyInformation

Bevat informatie over producthiërarchiegegevens

ManagementResourcePreferences

Beheerresourcevoorkeur om apparaat te koppelen

NotificationPreference

Meldingsvoorkeur voor een taakfase.

NotificationStageName

Naam van de fase.

OrderItemCancellationEnum

Beschrijft of het orderitem kan worden geannuleerd of niet.

OrderItemDetails

Details van orderitem

OrderItemResource

Vertegenwoordigt orderitemcontract

OrderItemReturnEnum

Beschrijft of het orderitem retourneert of niet.

OrderItemType

Orderitemtype.

OrderItemUpdateParameter

Hiermee worden orderitemparameters bijgewerkt.

Preferences

Voorkeuren met betrekking tot de bestelling

ProductDetails

Vertegenwoordigt productdetails

ResourceProviderDetails

Details van beheer-RP

ReverseShippingDetails

Details van omgekeerde verzending.

ShippingAddress

Verzendadres waar de klant het apparaat wil ontvangen.

StageDetails

Details van resourcefase.

StageName

Fasenaam

StageStatus

Fasestatus.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

TransportPreferences

Voorkeuren met betrekking tot de verzendingslogistiek van de sKU

TransportShipmentTypes

Hiermee wordt het type Verzendingslogistiek aangegeven dat de klant de voorkeur heeft gegeven.

ActionStatusEnum

Beschrijft of het orderitem al dan niet kan worden verwijdert.

Waarde Description
Allowed

Vlag toegestaan.

NotAllowed

Vlag niet toegestaan.

AddressDetails

Adresgegevens voor een orderitem.

Name Type Description
forwardAddress

AddressProperties

Klantadres en contactgegevens. Dit moet een adresresource zijn

returnAddress

AddressProperties

Verzendadres retourneren

AddressProperties

Adreseigenschappen

Name Type Description
addressValidationStatus

AddressValidationStatus

Status van adresvalidatie

contactDetails

ContactDetails

Contactgegevens voor het adres

shippingAddress

ShippingAddress

Verzendgegevens voor het adres

AddressType

Type adres.

Waarde Description
Commercial

Commercieel adres.

None

Adrestype niet bekend.

Residential

Woonadres.

AddressValidationStatus

Status van adresvalidatie

Waarde Description
Ambiguous

Het opgegeven adres is dubbelzinnig. Kies een van de alternatieve adressen die worden geretourneerd.

Invalid

Het opgegeven adres is ongeldig of wordt niet ondersteund.

Valid

Het opgegeven adres is geldig.

ContactDetails

Contactgegevens.

Name Type Description
contactName

string

Naam van de contactpersoon.

emailList

string[]

Lijst met e-mail-id's die moeten worden geïnformeerd over de voortgang van de taak.

mobile

string

Mobiel nummer van de contactpersoon.

phone

string

Telefoonnummer van de contactpersoon.

phoneExtension

string

Telefoonnummer van de contactpersoon.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
Application
Key
ManagedIdentity
User

DeviceDetails

Apparaatdetails.

Name Type Description
managementResourceId

string

Beheerresource-id

managementResourceTenantId

string

Tenant-id van beheerresource

serialNumber

string

serienummer van apparaat

DisplayInfo

Beschrijft productweergave-informatie

Name Type Description
configurationDisplayName

string

Weergavenaam van configuratie

productFamilyDisplayName

string

Weergavenaam van productfamilie

DoubleEncryptionStatus

Dubbele versleutelingsstatus zoals ingevoerd door de klant. Het is verplicht om deze parameter te geven als het beleid Weigeren of Uitgeschakeld is geconfigureerd.

Waarde Description
Disabled

Dubbele versleuteling is uitgeschakeld

Enabled

Dubbele versleuteling is ingeschakeld

EncryptionPreferences

Voorkeuren met betrekking tot dubbele versleuteling

Name Type Description
doubleEncryptionStatus

DoubleEncryptionStatus

Dubbele versleutelingsstatus zoals ingevoerd door de klant. Het is verplicht om deze parameter te geven als het beleid Weigeren of Uitgeschakeld is geconfigureerd.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ForwardShippingDetails

Verzendgegevens door.

Name Type Description
carrierDisplayName

string

Naam van de provider voor weergavedoeleinden. Niet te gebruiken voor verwerking.

carrierName

string

Naam van de vervoerder.

trackingId

string

TrackingId van het pakket

trackingUrl

string

TrackingUrl van het pakket.

HierarchyInformation

Bevat informatie over producthiërarchiegegevens

Name Type Description
configurationName

string

Vertegenwoordigt de configuratienaam die de configuratie uniek identificeert

productFamilyName

string

Vertegenwoordigt de productfamilienaam die uniek productfamilie identificeert

productLineName

string

Vertegenwoordigt de productlijnnaam waarmee productlijn uniek wordt geïdentificeerd

productName

string

Vertegenwoordigt productnaam die het product uniek identificeert

ManagementResourcePreferences

Beheerresourcevoorkeur om apparaat te koppelen

Name Type Description
preferredManagementResourceId

string

ARM-id van de klant voorkeursbeheerresource

NotificationPreference

Meldingsvoorkeur voor een taakfase.

Name Type Description
sendNotification

boolean

Melding is vereist of niet.

stageName

NotificationStageName

Naam van de fase.

NotificationStageName

Naam van de fase.

Waarde Description
Delivered

Melding bij orderitem dat aan de klant wordt geleverd.

Shipped

Melding bij orderitem dat is verzonden vanuit het Microsoft-datacenter.

OrderItemCancellationEnum

Beschrijft of het orderitem kan worden geannuleerd of niet.

Waarde Description
Cancellable

Orderitem kan zonder kosten worden geannuleerd.

CancellableWithFee

Orderitem kan worden geannuleerd met kosten.

NotCancellable

Orderitem kan niet worden geannuleerd.

OrderItemDetails

Details van orderitem

Name Type Description
cancellationReason

string

Annuleringsreden.

cancellationStatus

OrderItemCancellationEnum

Beschrijft of het orderitem kan worden geannuleerd of niet.

currentStage

StageDetails

Status van huidig orderitem

deletionStatus

ActionStatusEnum

Beschrijft of het orderitem al dan niet kan worden verwijdert.

error

ErrorDetail

Fout op het hoogste niveau voor de taak.

forwardShippingDetails

ForwardShippingDetails

Verzenddetails van pakket doorsturen

managementRpDetails

ResourceProviderDetails

Bovenliggende RP-details: hiermee wordt alleen de eerste of standaard bovenliggende RP uit de hele lijst geretourneerd

managementRpDetailsList

ResourceProviderDetails[]

Lijst met bovenliggende RP-details die worden ondersteund voor configuratie.

notificationEmailList

string[]

Aanvullende lijst met e-mailmeldingen

orderItemStageHistory

StageDetails[]

Statusgeschiedenis van orderitem

orderItemType

OrderItemType

Orderitemtype.

preferences

Preferences

Voorkeuren voor klantmeldingen

productDetails

ProductDetails

Unieke id voor configuratie.

returnReason

string

Retourreden.

returnStatus

OrderItemReturnEnum

Beschrijft of het orderitem retourneert of niet.

reverseShippingDetails

ReverseShippingDetails

Details van omgekeerde pakketverzending

OrderItemResource

Vertegenwoordigt orderitemcontract

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.addressDetails

AddressDetails

Vertegenwoordigt verzend- en retouradres voor orderitem

properties.orderId

string

Id van de order waartoe orderitem behoort

properties.orderItemDetails

OrderItemDetails

Vertegenwoordigt orderitemgegevens.

properties.startTime

string (date-time)

Begintijd van orderitem

systemData

systemData

Vertegenwoordigt het maken en bijwerken van resources

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

OrderItemReturnEnum

Beschrijft of het orderitem retourneert of niet.

Waarde Description
NotReturnable

Orderitem kan niet worden geretourneerd.

Returnable

Orderitem kan zonder kosten worden geretourneerd.

ReturnableWithFee

Orderitem kan worden geretourneerd met kosten.

OrderItemType

Orderitemtype.

Waarde Description
Purchase

Inkooporderitem.

Rental

HuurorderItem.

OrderItemUpdateParameter

Hiermee worden orderitemparameters bijgewerkt.

Name Type Description
properties.forwardAddress

AddressProperties

Hiermee worden het verzendadres en contactgegevens bijgewerkt.

properties.notificationEmailList

string[]

Aanvullende lijst met e-mailmeldingen.

properties.preferences

Preferences

Klantvoorkeur.

tags

object

De lijst met sleutel-waardeparen die de resource beschrijven. Deze tags kunnen worden gebruikt voor het weergeven en groeperen van deze resource (tussen resourcegroepen).

Preferences

Voorkeuren met betrekking tot de bestelling

Name Type Description
encryptionPreferences

EncryptionPreferences

Voorkeuren met betrekking tot de versleuteling.

managementResourcePreferences

ManagementResourcePreferences

Voorkeuren met betrekking tot de beheerresource.

notificationPreferences

NotificationPreference[]

Berichtgevingsvoorkeuren.

transportPreferences

TransportPreferences

Voorkeuren met betrekking tot de logistiek van de verzending van de bestelling.

ProductDetails

Vertegenwoordigt productdetails

Name Type Description
count

integer (int32)

Hoeveelheid van het product

deviceDetails

DeviceDetails[]

lijst met apparaatdetails

displayInfo

DisplayInfo

Details van het product weergeven

hierarchyInformation

HierarchyInformation

Hiërarchie van het product dat het product uniek identificeert

productDoubleEncryptionStatus

DoubleEncryptionStatus

Dubbele versleutelingsstatus van de configuratie. Alleen-lezenveld.

ResourceProviderDetails

Details van beheer-RP

Name Type Description
resourceProviderNamespace

string

Naamruimte van resourceprovider

ReverseShippingDetails

Details van omgekeerde verzending.

Name Type Description
carrierDisplayName

string

Naam van de provider voor weergavedoeleinden. Niet te gebruiken voor verwerking.

carrierName

string

Naam van de vervoerder.

sasKeyForLabel

string

SAS-sleutel om het label voor omgekeerde verzending van het pakket te downloaden.

trackingId

string

TrackingId van het pakket

trackingUrl

string

TrackingUrl van het pakket.

ShippingAddress

Verzendadres waar de klant het apparaat wil ontvangen.

Name Type Description
addressType

AddressType

Type adres.

city

string

Naam van de stad.

companyName

string

Naam van het bedrijf.

country

string

Naam van het land.

postalCode

string

Postcode.

stateOrProvince

string

Naam van de staat of provincie.

streetAddress1

string

Adresregel 1.

streetAddress2

string

Adresregel 2.

streetAddress3

string

Adresregel 3.

zipExtendedCode

string

Uitgebreide postcode.

StageDetails

Details van resourcefase.

Name Type Description
displayName

string

Weergavenaam van de resourcefase.

stageName

StageName

Fasenaam

stageStatus

StageStatus

Fasestatus.

startTime

string (date-time)

Begintijd van fase

StageName

Fasenaam

Waarde Description
Cancelled

De bestelling is geannuleerd.

Confirmed

Bestelling wordt bevestigd

Delivered

Bestelling wordt aan de klant geleverd

InReview

Bestelling bevindt zich momenteel in de conceptmodus en kan nog steeds worden geannuleerd

InUse

Bestelling wordt gebruikt op de klantsite

Placed

Momenteel in conceptmodus en kan nog steeds worden geannuleerd

ReadyToShip

Bestelling is gereed voor verzending

ReturnCompleted

Return is nu voltooid.

ReturnInitiated

Return is geïnitieerd door de klant.

ReturnPickedUp

Bestelling is onderweg van klant naar Microsoft.

ReturnedToMicrosoft

Bestelling is teruggestuurd naar Microsoft.

Shipped

Bestelling is onderweg naar klant

StageStatus

Fasestatus.

Waarde Description
Cancelled

Fase is geannuleerd.

Cancelling

Fase wordt geannuleerd.

Failed

Fase is mislukt.

InProgress

Fase wordt uitgevoerd.

None

Er is nog geen status beschikbaar.

Succeeded

De fase is geslaagd.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

TransportPreferences

Voorkeuren met betrekking tot de verzendingslogistiek van de sKU

Name Type Description
preferredShipmentType

TransportShipmentTypes

Hiermee wordt het type Verzendingslogistiek aangegeven dat de klant de voorkeur heeft gegeven.

TransportShipmentTypes

Hiermee wordt het type Verzendingslogistiek aangegeven dat de klant de voorkeur heeft gegeven.

Waarde Description
CustomerManaged

Verzendingslogistiek wordt afgehandeld door de klant.

MicrosoftManaged

Verzendingslogistiek wordt afgehandeld door Microsoft.