Class ServiceProfilesImpl
- All Implemented Interfaces:
ServiceProfiles
- Author:
- ianjones
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptioncreateAction(String uuid, String type, String description) Accepts or rejects a pending update on a service profile.define(ServiceProfileType serviceProfileType) Begins the fluent builder for creating a new service profile.Retrieves a single service profile by its unique identifier.getEnvironments(String serviceProfileUuid) Lists the provider environments of anIC_PROFILEservice profile:GET /fabric/v4/serviceProfiles/{serviceProfileId}/environments(catalog operationgetServiceProfileEnvironmentsByUuid).Lists the metros in which a service profile is available.list()Lists all service profiles owned by the current account.search()Searches for service profiles using default filter and sort criteria.search(FilterPropertyList filter) Searches for service profiles matching the specified filter criteria.search(FilterPropertyList filter, SortPropertyList sort) Searches for service profiles matching the specified filter and sort criteria.search(SortPropertyList sort) Searches for service profiles with the specified sort order.Begins a fluent PATCH update of an existing service profile, e.g.validateActivationKey(String serviceProfileUuid, String environmentUuid, ActivationKeyDetails keyDetails) Variant ofServiceProfiles.validateActivationKey(String, String, String)that sends a caller-builtkeyDetailsobject.Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface ServiceProfiles
validateActivationKeyModifier and TypeMethodDescriptiondefault EnvironmentActionResponsevalidateActivationKey(String serviceProfileUuid, String environmentUuid, String activationKey) Validates an activation key against a provider environment:POST /fabric/v4/serviceProfiles/{serviceProfileId}/environments/{environmentId}/actions(catalog operationserviceProfileEnvironmentAction) with the body of the catalog'sValidateActivationKeyexample:
-
Constructor Details
-
ServiceProfilesImpl
public ServiceProfilesImpl()
-
-
Method Details
-
list
Description copied from interface:ServiceProfilesLists all service profiles owned by the current account.- Specified by:
listin interfaceServiceProfiles- Returns:
- a paginated list of service profiles
-
search
Description copied from interface:ServiceProfilesSearches for service profiles using default filter and sort criteria.- Specified by:
searchin interfaceServiceProfiles- Returns:
- a paginated, filtered list of matching service profiles
-
search
Description copied from interface:ServiceProfilesSearches for service profiles matching the specified filter criteria.- Specified by:
searchin interfaceServiceProfiles- Parameters:
filter- the filter criteria to apply- Returns:
- a paginated, filtered list of matching service profiles
-
search
Description copied from interface:ServiceProfilesSearches for service profiles with the specified sort order.- Specified by:
searchin interfaceServiceProfiles- Parameters:
sort- the sort criteria to apply- Returns:
- a paginated, filtered list of matching service profiles
-
search
public PaginatedFilteredList<ServiceProfile> search(FilterPropertyList filter, SortPropertyList sort) Description copied from interface:ServiceProfilesSearches for service profiles matching the specified filter and sort criteria.- Specified by:
searchin interfaceServiceProfiles- Parameters:
filter- the filter criteria to applysort- the sort criteria to apply- Returns:
- a paginated, filtered list of matching service profiles
-
getByUuid
Description copied from interface:ServiceProfilesRetrieves a single service profile by its unique identifier.- Specified by:
getByUuidin interfaceServiceProfiles- Parameters:
uuid- the unique identifier of the service profile- Returns:
- the service profile matching the given UUID
-
define
Description copied from interface:ServiceProfilesBegins the fluent builder for creating a new service profile. Call methods on the returned builder to configure the profile, then callcreate().- Specified by:
definein interfaceServiceProfiles- Parameters:
serviceProfileType- the type of service profile to create- Returns:
- a builder for configuring the new service profile
-
update
Description copied from interface:ServiceProfilesBegins a fluent PATCH update of an existing service profile, e.g.serviceProfiles.update(uuid).name("New-Name").save().- Specified by:
updatein interfaceServiceProfiles- Parameters:
uuid- the unique identifier of the service profile to update- Returns:
- a fluent updater
-
createAction
Description copied from interface:ServiceProfilesAccepts or rejects a pending update on a service profile.- Specified by:
createActionin interfaceServiceProfiles- Parameters:
uuid- the unique identifier of the service profiletype- the action type (for examplePROFILE_UPDATE_ACCEPTANCEorPROFILE_UPDATE_REJECTION)description- an optional description for the action (may benull)- Returns:
- the action result
-
getMetros
Description copied from interface:ServiceProfilesLists the metros in which a service profile is available.- Specified by:
getMetrosin interfaceServiceProfiles- Parameters:
uuid- the unique identifier of the service profile- Returns:
- the list of service metros
-
getEnvironments
Description copied from interface:ServiceProfilesLists the provider environments of anIC_PROFILEservice profile:GET /fabric/v4/serviceProfiles/{serviceProfileId}/environments(catalog operationgetServiceProfileEnvironmentsByUuid).The endpoint is paginated with
offset/limitquery parameters. This method follows the server-reported pagination and issues one GET per page until the last page, so the returned list holds every environment. The list is an unmodifiable snapshot. A failure on any page propagates asEquinixServiceException(or its status-specific subclass) and no partial list is returned.The same objects are embedded in
ServiceProfile.getEnvironments()when the profile itself is fetched.Beta: the operation and the
ProviderEnvironmentschema carry the Fabric v4 catalog's Beta marker (catalog fetched 2026-09-21). The behaviour for a profile whose type is notIC_PROFILEis not documented.Declared
defaultso implementations of this interface written before the method existed still compile. The default throws; the client returned byFabric.serviceProfiles()overrides it.- Specified by:
getEnvironmentsin interfaceServiceProfiles- Parameters:
serviceProfileUuid- the unique identifier of the service profile- Returns:
- every provider environment of the profile; empty if there are none
-
validateActivationKey
public EnvironmentActionResponse validateActivationKey(String serviceProfileUuid, String environmentUuid, ActivationKeyDetails keyDetails) Description copied from interface:ServiceProfilesVariant ofServiceProfiles.validateActivationKey(String, String, String)that sends a caller-builtkeyDetailsobject. TheActivationKeyDetailsschema marks no property required or read-only, soproviderId,accountId,bandwidth(Mbps) andregioncan be sent withvalue. Null properties are omitted.Beta: the catalog's only request example sends
valuealone. How the service treats the other properties on a request is unverified.Declared
defaultfor the same reason asServiceProfiles.getEnvironments(String). The default throws; the client returned byFabric.serviceProfiles()overrides it.- Specified by:
validateActivationKeyin interfaceServiceProfiles- Parameters:
serviceProfileUuid- the unique identifier of theIC_PROFILEservice profileenvironmentUuid- the provider environment identifierkeyDetails- the activation key details to send- Returns:
- the action response
-