Struct Client 

pub struct Client { /* private fields */ }

Client for Agent Registry Control

Client for invoking operations on Agent Registry Control. Each operation on Agent Registry Control is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Constructing a Client

A Config is required to construct a client. For most use cases, the aws-config crate should be used to automatically resolve this config using aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared across multiple different AWS SDK clients. This config resolution process can be customized by calling aws_config::from_env() instead, which returns a ConfigLoader that uses the builder pattern to customize the default config.

In the simplest case, creating a client looks as follows:

let config = aws_config::load_from_env().await;
let client = aws_sdk_agentregistrycontrol::Client::new(&config);

Occasionally, SDKs may have additional service-specific values that can be set on the Config that is absent from SdkConfig, or slightly different settings for a specific client may be desired. The Builder struct implements From<&SdkConfig>, so setting these specific settings can be done as follows:

let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_agentregistrycontrol::config::Builder::from(&sdk_config)
    .some_service_specific_setting("value")
    .build();

See the aws-config docs and Config for more information on customizing configuration.

Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.

Using the Client

A client has a function for every operation that can be performed by the service. For example, the CreateRegistry operation has a Client::create_registry, function which returns a builder for that operation. The fluent builder ultimately has a send() function that returns an async future that returns a result, as illustrated below:

let result = client.create_registry()
    .name("example")
    .send()
    .await;

The underlying HTTP requests that get made by this can be modified with the customize_operation function on the fluent builder. See the customize module for more information.

Waiters

This client provides wait_until methods behind the Waiters trait. To use them, simply import the trait, and then call one of the wait_until methods. This will return a waiter fluent builder that takes various parameters, which are documented on the builder type. Once parameters have been provided, the wait method can be called to initiate waiting.

For example, if there was a wait_until_thing method, it could look like:

let result = client.wait_until_thing()
    .thing_id("someId")
    .wait(Duration::from_secs(120))
    .await;

Implementations

impl Client

pub fn create_registry(&self) -> CreateRegistryFluentBuilder

Constructs a fluent builder for the CreateRegistry operation.

• The fluent builder is configurable:
  • name(impl Into<String>) / set_name(Option<String>):
    required: true
    

    The name of the registry

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The description of the registry

    
    
  • discovery_configuration(DiscoveryConfiguration) / set_discovery_configuration(Option<DiscoveryConfiguration>):
    required: false
    

    Discovery configuration for the registry

    
    
  • client_token(impl Into<String>) / set_client_token(Option<String>):
    required: false
    

    Client token for idempotency

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: false
    

    Tags to associate with the registry

    
    
  • approval_configuration(ApprovalConfiguration) / set_approval_configuration(Option<ApprovalConfiguration>):
    required: false
    

    Approval configuration for registry records

    
    
• On success, responds with CreateRegistryOutput with field(s):
  • registry_arn(String):

    The ARN of the created registry

• On failure, responds with SdkError<CreateRegistryError>

impl Client

pub fn create_registry_record(&self) -> CreateRegistryRecordFluentBuilder

Constructs a fluent builder for the CreateRegistryRecord operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry in which to create the record (ARN or ID)

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: true
    

    The name of the registry record

    
    
  • display_name(impl Into<String>) / set_display_name(Option<String>):
    required: false
    

    The human-readable display name of the registry record

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The description of the registry record

    
    
  • record_type(RecordType) / set_record_type(Option<RecordType>):
    required: true
    

    The type of the registry record, which determines the descriptor format

    
    
  • descriptors(Descriptors) / set_descriptors(Option<Descriptors>):
    required: true
    

    The typed descriptor content for the registry record

    
    
  • record_version(impl Into<String>) / set_record_version(Option<String>):
    required: false
    

    The version of the registry record

    
    
  • client_token(impl Into<String>) / set_client_token(Option<String>):
    required: false
    

    Client token for idempotency

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: false
    

    Tags to associate with the registry record

    
    
• On success, responds with CreateRegistryRecordOutput with field(s):
  • record_arn(String):

    The ARN of the created registry record

  • status(RegistryRecordStatus):

    The status of the registry record, set to CREATING while the asynchronous workflow is in progress

• On failure, responds with SdkError<CreateRegistryRecordError>

impl Client

pub fn delete_registry(&self) -> DeleteRegistryFluentBuilder

Constructs a fluent builder for the DeleteRegistry operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry to delete (ARN or ID)

    
    
• On success, responds with DeleteRegistryOutput with field(s):
  • status(RegistryStatus):

    Current status of the registry, set to DELETING when deletion is initiated

• On failure, responds with SdkError<DeleteRegistryError>

impl Client

pub fn delete_registry_record(&self) -> DeleteRegistryRecordFluentBuilder

Constructs a fluent builder for the DeleteRegistryRecord operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry containing the record (ARN or ID)

    
    
  • record_id(impl Into<String>) / set_record_id(Option<String>):
    required: true
    

    The identifier of the registry record to delete (ARN or ID)

    
    
• On success, responds with DeleteRegistryRecordOutput
• On failure, responds with SdkError<DeleteRegistryRecordError>

impl Client

pub fn get_registry(&self) -> GetRegistryFluentBuilder

Constructs a fluent builder for the GetRegistry operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry to retrieve (ARN or ID)

    
    
• On success, responds with GetRegistryOutput with field(s):
  • name(String):

    The name of the registry

  • description(Option<String>):

    The description of the registry

  • registry_id(String):

    The unique identifier of the registry

  • registry_arn(String):

    The ARN of the registry

  • discovery_configuration(Option<DiscoveryConfiguration>):

    Discovery configuration for the registry

  • approval_configuration(Option<ApprovalConfiguration>):

    Approval configuration for registry records

  • status(RegistryStatus):

    Current status of the registry

  • status_reason(Option<String>):

    The reason for the current status. Typically populated when the status indicates a failure state.

  • created_at(DateTime):

    The timestamp when the registry was created

  • updated_at(DateTime):

    The timestamp when the registry was last updated

• On failure, responds with SdkError<GetRegistryError>

impl Client

pub fn get_registry_record(&self) -> GetRegistryRecordFluentBuilder

Constructs a fluent builder for the GetRegistryRecord operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry containing the record (ARN or ID)

    
    
  • record_id(impl Into<String>) / set_record_id(Option<String>):
    required: true
    

    The identifier of the registry record to retrieve (ARN or ID)

    
    
• On success, responds with GetRegistryRecordOutput with field(s):
  • registry_arn(String):

    The &ARN; of the parent registry that owns the record.

  • record_arn(String):

    The &ARN; of the registry record.

  • record_id(String):

    The unique identifier of the registry record.

  • name(String):

    The name of the registry record. Names are unique within a registry.

  • display_name(Option<String>):

    The human-readable display name of the registry record.

  • description(Option<String>):

    A description of the registry record.

  • record_type(RecordType):

    The type of the registry record, such as MCP, AGENT, SKILL, or CUSTOM.

  • descriptors(Option<Descriptors>):

    The typed descriptors that define the content of the registry record.

  • record_version(Option<String>):

    The version identifier of the registry record.

  • status(RegistryRecordStatus):

    The lifecycle status of the registry record.

  • created_at(DateTime):

    The timestamp when the registry record was created.

  • updated_at(DateTime):

    The timestamp when the registry record was last updated.

  • status_reason(Option<String>):

    The reason for the current status. Typically populated when the status indicates a failure state.

• On failure, responds with SdkError<GetRegistryRecordError>

impl Client

pub fn list_registries(&self) -> ListRegistriesFluentBuilder

Constructs a fluent builder for the ListRegistries operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    Maximum number of results to return

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    Token for pagination

    
    
  • filters(RegistryFilter) / set_filters(Option<Vec::<RegistryFilter>>):
    required: false
    

    Filters to apply to the registry list

    
    
• On success, responds with ListRegistriesOutput with field(s):
  • registries(Vec::<RegistrySummary>):

    List of registry summaries

  • next_token(Option<String>):

    Token for next page of results

• On failure, responds with SdkError<ListRegistriesError>

impl Client

pub fn list_registry_records(&self) -> ListRegistryRecordsFluentBuilder

Constructs a fluent builder for the ListRegistryRecords operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry to list records from (ARN or ID)

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    Maximum number of records to return

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    Token for pagination

    
    
  • filters(RegistryRecordFilter) / set_filters(Option<Vec::<RegistryRecordFilter>>):
    required: false
    

    Filters to apply to the registry record list

    
    
• On success, responds with ListRegistryRecordsOutput with field(s):
  • registry_records(Vec::<RegistryRecordSummary>):

    List of registry record summaries

  • next_token(Option<String>):

    Token for next page of results

• On failure, responds with SdkError<ListRegistryRecordsError>

impl Client

pub fn list_tags_for_resource(&self) -> ListTagsForResourceFluentBuilder

Constructs a fluent builder for the ListTagsForResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):
    required: true
    ARN of a taggable Agent Registry resource.
    
• On success, responds with ListTagsForResourceOutput with field(s):
  • tags(Option<HashMap::<String, String>>): A map of tag keys to tag values returned by read operations (may be empty).
• On failure, responds with SdkError<ListTagsForResourceError>

impl Client

pub fn submit_registry_record_for_approval( &self, ) -> SubmitRegistryRecordForApprovalFluentBuilder

Constructs a fluent builder for the SubmitRegistryRecordForApproval operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry containing the record (ARN or ID)

    
    
  • record_id(impl Into<String>) / set_record_id(Option<String>):
    required: true
    

    The identifier of the registry record to submit for approval (ARN or ID)

    
    
• On success, responds with SubmitRegistryRecordForApprovalOutput with field(s):
  • registry_arn(String):

    The ARN of the registry

  • record_arn(String):

    The ARN of the registry record

  • record_id(String):

    The ID of the registry record

  • status(RegistryRecordStatus):

    The resulting status of the registry record

  • updated_at(DateTime):

    The timestamp when the record was last updated

• On failure, responds with SdkError<SubmitRegistryRecordForApprovalError>

impl Client

pub fn tag_resource(&self) -> TagResourceFluentBuilder

Constructs a fluent builder for the TagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):
    required: true
    ARN of a taggable Agent Registry resource.
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: true
    A map of tag keys to tag values.
    
• On success, responds with TagResourceOutput
• On failure, responds with SdkError<TagResourceError>

impl Client

pub fn untag_resource(&self) -> UntagResourceFluentBuilder

Constructs a fluent builder for the UntagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):
    required: true
    ARN of a taggable Agent Registry resource.
    
  • tag_keys(impl Into<String>) / set_tag_keys(Option<Vec::<String>>):
    required: true
    A list of tag keys.
    
• On success, responds with UntagResourceOutput
• On failure, responds with SdkError<UntagResourceError>

impl Client

pub fn update_registry(&self) -> UpdateRegistryFluentBuilder

Constructs a fluent builder for the UpdateRegistry operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry to update (ARN or ID)

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: false
    

    The updated name of the registry

    
    
  • description(UpdatedDescription) / set_description(Option<UpdatedDescription>):
    required: false
    

    The updated description of the registry

    
    
  • discovery_configuration(UpdatedDiscoveryConfiguration) / set_discovery_configuration(Option<UpdatedDiscoveryConfiguration>):
    required: false
    

    The updated discovery configuration. Changing the discovery authorization can break existing consumers that rely on the previous authorization type.

    
    
  • approval_configuration(UpdatedApprovalConfiguration) / set_approval_configuration(Option<UpdatedApprovalConfiguration>):
    required: false
    

    The updated approval configuration. The change applies only to records that move to PENDING_APPROVAL after the update; records already in PENDING_APPROVAL are unaffected.

    
    
• On success, responds with UpdateRegistryOutput with field(s):
  • name(String):

    The name of the registry

  • description(Option<String>):

    The description of the registry

  • registry_id(String):

    The unique identifier of the registry

  • registry_arn(String):

    The ARN of the registry

  • discovery_configuration(Option<DiscoveryConfiguration>):

    Discovery configuration for the registry

  • approval_configuration(Option<ApprovalConfiguration>):

    Approval configuration for registry records

  • status(RegistryStatus):

    Current status of the registry

  • status_reason(Option<String>):

    The reason for the current status. Typically populated when the status indicates a failure state.

  • created_at(DateTime):

    The timestamp when the registry was created

  • updated_at(DateTime):

    The timestamp when the registry was last updated

• On failure, responds with SdkError<UpdateRegistryError>

impl Client

pub fn update_registry_record(&self) -> UpdateRegistryRecordFluentBuilder

Constructs a fluent builder for the UpdateRegistryRecord operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry containing the record (ARN or ID)

    
    
  • record_id(impl Into<String>) / set_record_id(Option<String>):
    required: true
    

    The identifier of the registry record to update (ARN or ID)

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: false
    

    The updated name of the registry record. Omit to leave the name unchanged.

    
    
  • display_name(UpdatedDisplayName) / set_display_name(Option<UpdatedDisplayName>):
    required: false
    

    The updated display name of the registry record. Omit to leave the display name unchanged; provide an empty wrapper to unset it.

    
    
  • description(UpdatedDescription) / set_description(Option<UpdatedDescription>):
    required: false
    

    The updated description of the registry record. Omit to leave the description unchanged; provide an empty wrapper to unset it.

    
    
  • record_type(RecordType) / set_record_type(Option<RecordType>):
    required: false
    

    The updated type of the registry record. Omit to leave the record type unchanged.

    
    
  • descriptors(UpdatedDescriptors) / set_descriptors(Option<UpdatedDescriptors>):
    required: false
    

    The updated typed descriptor content for the registry record. Omit to leave the descriptors unchanged.

    
    
  • record_version(impl Into<String>) / set_record_version(Option<String>):
    required: false
    

    The updated version of the registry record. Omit to leave the version unchanged.

    
    
  • trigger_synchronization(bool) / set_trigger_synchronization(Option<bool>):
    required: false
    

    Whether to trigger synchronization of the record’s descriptor content from its source

    
    
• On success, responds with UpdateRegistryRecordOutput with field(s):
  • registry_arn(String):

    The &ARN; of the parent registry that owns the record.

  • record_arn(String):

    The &ARN; of the registry record.

  • record_id(String):

    The unique identifier of the registry record.

  • name(String):

    The name of the registry record. Names are unique within a registry.

  • display_name(Option<String>):

    The human-readable display name of the registry record.

  • description(Option<String>):

    A description of the registry record.

  • record_type(RecordType):

    The type of the registry record, such as MCP, AGENT, SKILL, or CUSTOM.

  • descriptors(Option<Descriptors>):

    The typed descriptors that define the content of the registry record.

  • record_version(Option<String>):

    The version identifier of the registry record.

  • status(RegistryRecordStatus):

    The lifecycle status of the registry record.

  • created_at(DateTime):

    The timestamp when the registry record was created.

  • updated_at(DateTime):

    The timestamp when the registry record was last updated.

  • status_reason(Option<String>):

    The reason for the current status. Typically populated when the status indicates a failure state.

• On failure, responds with SdkError<UpdateRegistryRecordError>

impl Client

pub fn update_registry_record_status( &self, ) -> UpdateRegistryRecordStatusFluentBuilder

Constructs a fluent builder for the UpdateRegistryRecordStatus operation.

• The fluent builder is configurable:
  • registry_id(impl Into<String>) / set_registry_id(Option<String>):
    required: true
    

    The identifier of the registry containing the record (ARN or ID)

    
    
  • record_id(impl Into<String>) / set_record_id(Option<String>):
    required: true
    

    The identifier of the registry record to update the status of (ARN or ID)

    
    
  • status(RegistryRecordStatus) / set_status(Option<RegistryRecordStatus>):
    required: true
    

    The target status for the registry record

    
    
  • status_reason(impl Into<String>) / set_status_reason(Option<String>):
    required: true
    

    The reason for the status change, for example why the record was approved, rejected, or deprecated

    
    
• On success, responds with UpdateRegistryRecordStatusOutput with field(s):
  • registry_arn(String):

    The ARN of the registry

  • record_arn(String):

    The ARN of the registry record

  • record_id(String):

    The ID of the registry record

  • status(RegistryRecordStatus):

    The resulting status of the registry record

  • status_reason(String):

    The reason for the status change

  • updated_at(DateTime):

    The timestamp when the record was last updated

• On failure, responds with SdkError<UpdateRegistryRecordStatusError>

impl Client

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

This method will panic in the following cases:

• Retries or timeouts are enabled without a sleep_impl configured.
• Identity caching is enabled without a sleep_impl and time_source configured.
• No behavior_version is provided.

The panic message for each of these will have instructions on how to resolve them.

pub fn config(&self) -> &Config

Returns the client’s configuration.

impl Client

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics

• This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.
• This method will panic if no BehaviorVersion is provided. If you experience this panic, set behavior_version on the Config or enable the behavior-version-latest Cargo feature.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Waiters for Client

fn wait_until_registry_ready(&self) -> RegistryReadyFluentBuilder

Wait for registry_ready

fn wait_until_registry_record_approved( &self, ) -> RegistryRecordApprovedFluentBuilder

Wait for registry_record_approved