Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

StartNetworkResourceUpdate

Starts an update of the specified network resource.

After you submit a request to replace or return a network resource, the status of the network resource is CREATING_SHIPPING_LABEL. The shipping label is available when the status of the network resource is PENDING_RETURN. After the network resource is successfully returned, its status is DELETED. For more information, see Return a radio unit.

Request Syntax


POST /v1/network-resources/update HTTP/1.1
Content-type: application/json

{
   "networkResourceArn": "string",
   "returnReason": "string",
   "shippingAddress": { 
      "city": "string",
      "company": "string",
      "country": "string",
      "name": "string",
      "phoneNumber": "string",
      "postalCode": "string",
      "stateOrProvince": "string",
      "street1": "string",
      "street2": "string",
      "street3": "string"
   },
   "updateType": "string"
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

networkResourceArn

The Amazon Resource Name (ARN) of the network resource.

Type: String

Pattern: ^arn:aws:private-networks:[a-z0-9-]+:[^:]*:.*$

Required: Yes

returnReason

The reason for the return. Providing a reason for a return is optional.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1000.

Required: No

shippingAddress

The shipping address. If you don't provide a shipping address when replacing or returning a network resource, we use the address from the original order for the network resource.

Type: Address object

Required: No

updateType

The update type.

REPLACE - Submits a request to replace a defective radio unit. We provide a shipping label that you can use for the return process and we ship a replacement radio unit to you.
RETURN - Submits a request to replace a radio unit that you no longer need. We provide a shipping label that you can use for the return process.

Type: String

Valid Values: REPLACE | RETURN

Required: Yes

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "networkResource": { 
      "attributes": [ 
         { 
            "name": "string",
            "value": "string"
         }
      ],
      "createdAt": "string",
      "description": "string",
      "health": "string",
      "model": "string",
      "networkArn": "string",
      "networkResourceArn": "string",
      "networkSiteArn": "string",
      "orderArn": "string",
      "position": { 
         "elevation": number,
         "elevationReference": "string",
         "elevationUnit": "string",
         "latitude": number,
         "longitude": number
      },
      "returnInformation": { 
         "replacementOrderArn": "string",
         "returnReason": "string",
         "shippingAddress": { 
            "city": "string",
            "company": "string",
            "country": "string",
            "name": "string",
            "phoneNumber": "string",
            "postalCode": "string",
            "stateOrProvince": "string",
            "street1": "string",
            "street2": "string",
            "street3": "string"
         },
         "shippingLabel": "string"
      },
      "serialNumber": "string",
      "status": "string",
      "statusReason": "string",
      "type": "string",
      "vendor": "string"
   }
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

networkResource

The network resource.

Type: NetworkResource object

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerException

Information about an internal error.

HTTP Status Code: 500

ResourceNotFoundException

The resource was not found.

HTTP Status Code: 404

ValidationException

The request failed validation.

HTTP Status Code: 400