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 |
---|---|---|---|---|
order
|
path | True |
string |
De naam van het orderitem |
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig. |
subscription
|
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 |
Hiermee worden het verzendadres en contactgegevens bijgewerkt. |
|
properties.notificationEmailList |
string[] |
Aanvullende lijst met e-mailmeldingen. |
properties.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 |
Resourceobject orderitem. |
|
202 Accepted |
Geaccepteerde aanvraag voor het bijwerken van orderitems. |
|
Other Status Codes |
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 |
---|---|
Action |
Beschrijft of het orderitem al dan niet kan worden verwijdert. |
Address |
Adresgegevens voor een orderitem. |
Address |
Adreseigenschappen |
Address |
Type adres. |
Address |
Status van adresvalidatie |
Contact |
Contactgegevens. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Device |
Apparaatdetails. |
Display |
Beschrijft productweergave-informatie |
Double |
Dubbele versleutelingsstatus zoals ingevoerd door de klant. Het is verplicht om deze parameter te geven als het beleid Weigeren of Uitgeschakeld is geconfigureerd. |
Encryption |
Voorkeuren met betrekking tot dubbele versleuteling |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Forward |
Verzendgegevens door. |
Hierarchy |
Bevat informatie over producthiërarchiegegevens |
Management |
Beheerresourcevoorkeur om apparaat te koppelen |
Notification |
Meldingsvoorkeur voor een taakfase. |
Notification |
Naam van de fase. |
Order |
Beschrijft of het orderitem kan worden geannuleerd of niet. |
Order |
Details van orderitem |
Order |
Vertegenwoordigt orderitemcontract |
Order |
Beschrijft of het orderitem retourneert of niet. |
Order |
Orderitemtype. |
Order |
Hiermee worden orderitemparameters bijgewerkt. |
Preferences |
Voorkeuren met betrekking tot de bestelling |
Product |
Vertegenwoordigt productdetails |
Resource |
Details van beheer-RP |
Reverse |
Details van omgekeerde verzending. |
Shipping |
Verzendadres waar de klant het apparaat wil ontvangen. |
Stage |
Details van resourcefase. |
Stage |
Fasenaam |
Stage |
Fasestatus. |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
Transport |
Voorkeuren met betrekking tot de verzendingslogistiek van de sKU |
Transport |
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 |
Klantadres en contactgegevens. Dit moet een adresresource zijn |
|
returnAddress |
Verzendadres retourneren |
AddressProperties
Adreseigenschappen
Name | Type | Description |
---|---|---|
addressValidationStatus |
Status van adresvalidatie |
|
contactDetails |
Contactgegevens voor het adres |
|
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 |
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 |
De fout bevat aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
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 |
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 |
Beschrijft of het orderitem kan worden geannuleerd of niet. |
|
currentStage |
Status van huidig orderitem |
|
deletionStatus |
Beschrijft of het orderitem al dan niet kan worden verwijdert. |
|
error |
Fout op het hoogste niveau voor de taak. |
|
forwardShippingDetails |
Verzenddetails van pakket doorsturen |
|
managementRpDetails |
Bovenliggende RP-details: hiermee wordt alleen de eerste of standaard bovenliggende RP uit de hele lijst geretourneerd |
|
managementRpDetailsList |
Lijst met bovenliggende RP-details die worden ondersteund voor configuratie. |
|
notificationEmailList |
string[] |
Aanvullende lijst met e-mailmeldingen |
orderItemStageHistory |
Statusgeschiedenis van orderitem |
|
orderItemType |
Orderitemtype. |
|
preferences |
Voorkeuren voor klantmeldingen |
|
productDetails |
Unieke id voor configuratie. |
|
returnReason |
string |
Retourreden. |
returnStatus |
Beschrijft of het orderitem retourneert of niet. |
|
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 |
Vertegenwoordigt verzend- en retouradres voor orderitem |
|
properties.orderId |
string |
Id van de order waartoe orderitem behoort |
properties.orderItemDetails |
Vertegenwoordigt orderitemgegevens. |
|
properties.startTime |
string (date-time) |
Begintijd van orderitem |
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 |
Hiermee worden het verzendadres en contactgegevens bijgewerkt. |
|
properties.notificationEmailList |
string[] |
Aanvullende lijst met e-mailmeldingen. |
properties.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 |
Voorkeuren met betrekking tot de versleuteling. |
|
managementResourcePreferences |
Voorkeuren met betrekking tot de beheerresource. |
|
notificationPreferences |
Berichtgevingsvoorkeuren. |
|
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 |
lijst met apparaatdetails |
|
displayInfo |
Details van het product weergeven |
|
hierarchyInformation |
Hiërarchie van het product dat het product uniek identificeert |
|
productDoubleEncryptionStatus |
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 |
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 |
Fasenaam |
|
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 |
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 |
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 |
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. |