UpdateGeofenceCollectionCommand

Updates the specified properties of a given geofence collection.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { LocationClient, UpdateGeofenceCollectionCommand } from "@aws-sdk/client-location"; // ES Modules import
// const { LocationClient, UpdateGeofenceCollectionCommand } = require("@aws-sdk/client-location"); // CommonJS import
const client = new LocationClient(config);
const input = { // UpdateGeofenceCollectionRequest
  CollectionName: "STRING_VALUE", // required
  PricingPlan: "STRING_VALUE",
  PricingPlanDataSource: "STRING_VALUE",
  Description: "STRING_VALUE",
};
const command = new UpdateGeofenceCollectionCommand(input);
const response = await client.send(command);
// { // UpdateGeofenceCollectionResponse
//   CollectionName: "STRING_VALUE", // required
//   CollectionArn: "STRING_VALUE", // required
//   UpdateTime: new Date("TIMESTAMP"), // required
// };

UpdateGeofenceCollectionCommand Input

Parameter
Type
Description
CollectionName
Required
string | undefined

The name of the geofence collection to update.

Description
string | undefined

Updates the description for the geofence collection.

PricingPlan
PricingPlan | undefined

No longer used. If included, the only allowed value is RequestBasedUsage.

PricingPlanDataSource
string | undefined

This parameter is no longer used.

UpdateGeofenceCollectionCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
CollectionArn
Required
string | undefined

The Amazon Resource Name (ARN) of the updated geofence collection. Used to specify a resource across Amazon Web Services.

  • Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection

CollectionName
Required
string | undefined

The name of the updated geofence collection.

UpdateTime
Required
Date | undefined

The time when the geofence collection was last updated in ISO 8601  format: YYYY-MM-DDThh:mm:ss.sssZ

Throws

Name
Fault
Details
AccessDeniedException
client

The request was denied because of insufficient access or permissions. Check with an administrator to verify your permissions.

InternalServerException
server

The request has failed to process because of an unknown server error, exception, or failure.

ResourceNotFoundException
client

The resource that you've entered was not found in your AWS account.

ThrottlingException
client

The request was denied because of request throttling.

ValidationException
client

The input failed to meet the constraints specified by the AWS service.

LocationServiceException
Base exception class for all service exceptions from Location service.