vania-janet/multiturn-rag-retrieval-data huggingface dataset:
ibm_en_subscription.subscription1: Creation complete after 4s [id=24547d88-e455-548f-cb6e-ge921g6d3025/b2d88ff9-da10-412a-9f7a-19f509ea83fb]

Apply complete! Resources: 4 added, 0 changed, 0 destroyed..
Show more





 Step 7: Validating resources 

Validate resources within the IBM Cloud by selecting the resource list in [resources](https://cloud.ibm.com/resources).

For more information on API and SDK references, tutorials, and FAQs, for IBM Cloud products and services, see [Documentation](https://cloud.ibm.com/docs).
Development and Production catalogs behave differently:



* Development catalog:

If you select the development mode, staging and publishing actions are forced. If you republish a Product, it is overwritten without warning. If conflicts are found, they are automatically resolved by the system. Unpublish actions happen automatically.

Note: Approval boxes are not displayed for development Catalogs. You cannot enable the approval process for lifecycles.
* Production catalog:

You will be prevented from publishing a Product to a Production Catalog if there is already a Product in the Catalog with the same name and version; you must create a new version of the Product for publication. If Spaces are enabled in a production Catalog, you cannot publish a Product with the same name and version to more than one Space in the Catalog.

If you create a new Product that contains one or more modified APIs, you must create new versions of those APIs for inclusion in the Product. If the Product contains a modified API and there is already a published API with the same name and version, your changes will not be published.



b. If you want to enable automatic subscription for the Catalog, select Automatic subscription.

Enabling automatic subscription makes testing your APIs easier because a test application is used. The test application includes a pre-supplied client ID and client secret. The test application is automatically subscribed to all of the Plans in the Catalog, so you don't have to specify a plan or application when testing.

Note: Automatic subscription is available only for a development Catalog.

c. If the Catalog is the default staging Catalog, select Default. Then, calls to APIs that are published to the Catalog can use a shorter URL that does not include the Catalog name.

Note: You can select Default for one Catalog.

d. Optional: Click Endpoints, and populate the following fields:



* Custom Gateway URL: In the Custom Gateway URL text field, enter a URL. You use the Custom Gateway URL if you want to achieve custom branding of URLs for APIs that are deployed to API Connect, rather than using the default URL that API Manager generates. By default, the API Connect gateway URL has the following format:
createZoneOptions.SetExcluded([]contextbasedrestrictionsv1.AddressIntf{excludedIPAddressModel})

zone, response, err := contextBasedRestrictionsService.CreateZone(createZoneOptions)
if err != nil {
panic(err)
}
b, _ := json.MarshalIndent(zone, "", " ")
fmt.Println(string(b))

// Request models needed by this operation.

// AddressIPAddress
const ipAddressModel = {
type: 'ipAddress',
value: '169.23.56.234',
};
// AddressIPAddressRange
const ipRangeAddressModel = {
type: 'ipRange',
value: '169.23.22.0-169.23.22.255',
};
// AddressSubnet
const subnetAddressModel = {
type: 'subnet',
value: '192.0.2.0/24',
};
// AddressVPC
const vpcAddressModel = {
type: 'vpc',
value: vpcCRN,
};
// AddressServiceRef
const serviceRefAddressModel = {
type: 'serviceRef',
ref: {
account_id: accountId,
service_name: 'cloud-object-storage',
},
};
// AddressIPAddress
const excludedIPAddressModel = {
type: 'ipAddress',
value: '169.23.22.127',
};

const params = {
name: 'an example of zone',
accountId,
You can request to cancel your subscription before the end of the term, but whether the subscription can be canceled is at the discretion of IBM. Any remaining credit on your subscription might be forfeited. For more information, contact [Support](https://cloud.ibm.com/unifiedsupport/supportcenter). Make sure that you provide details about why you need to cancel your subscription.

To close a Pay-As-You-Go account or a Lite account, see [Can I cancel my account?](https://cloud.ibm.com/docs/account?topic=account-accountfaqscancelaccount).



Managing your account, resources, and access



* How do I create an IBM Cloud account?

You can create an account by [registering](https://cloud.ibm.com/registration) your email address. For identity verification, a credit card is required when you create a new account. New accounts are created as Pay-As-You-Go accounts, except purchased subscriptions. For more information, see [Account types](https://cloud.ibm.com/docs/account?topic=account-accounts).

Feature codes aren't supported in some countries. For more information, see [personal use availability](https://cloud.ibm.com/docs/account?topic=account-account-getting-startedsignup-personalaccts).
* How is my credit card authorized?

A credit card is required to create a new IBM Cloud account unless you have a subscription or feature code. As part of the authorization process, you might see a temporary hold on your credit card for verification and security when creating an account. This credit card hold is reversed within 24 to 72 hours. In many cases, a credit card isn't accepted because your credit card issuer didn't authorize it. For more information about issues with credit card authorization, see [Credit Card error messages](https://cloud.ibm.com/docs/billing-usage?topic=billing-usage-cc-error-messages).
* How do I get help with issues with creating an account?
curl -X PUT "$SERVICE_URL/users/_design/allusers" --data '{
"views": {
"getVerifiedEmails": {
"map": "function(user) { if(user.email_verified === true){ emit(doc.email, {name: user.name, email_verified: user.email_verified, joined: user.joined}) }}"
}
}
}'

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.DesignDocument;
import com.ibm.cloud.cloudant.v1.model.DesignDocumentViewsMapReduce;
import com.ibm.cloud.cloudant.v1.model.DocumentResult;
import com.ibm.cloud.cloudant.v1.model.PutDesignDocumentOptions;

import java.util.Collections;

Cloudant service = Cloudant.newInstance();

DesignDocumentViewsMapReduce emailViewMapReduce =
new DesignDocumentViewsMapReduce.Builder()
.map("function(user) { if(user.email_verified === true){ emit(doc.email,{name: user.name, email_verified: user.email_verified, joined: user.joined}) }")
.build();

DesignDocument designDocument = new DesignDocument();
designDocument.setViews(
Collections.singletonMap("getVerifiedEmails", emailViewMapReduce));

PutDesignDocumentOptions designDocumentOptions =
new PutDesignDocumentOptions.Builder()
.db("users")
.designDocument(designDocument)
.ddoc("allusers")
.build();

DocumentResult response =
service.putDesignDocument(designDocumentOptions).execute()
parameters = jsonencode([])
}
}






 How do I associate a public gateway while creating multiple zones with a Subnet for each zone? 


{

"StatusCode": 400,
"Headers": {

"Cache-Control": ["max-age=0, no-cache, no-store, must-revalidate"],
"Cf-Cache-Status": ["DYNAMIC"],
"Cf-Ray": ["6ab6a5e86ac41b69-DEL"],
"Connection": ["keep-alive"],
"Content-Length": ["261"],
"Content-Type": ["application/json; charset=utf-8"],
"Date": ["Tue, 09 Nov 2021 11:19:47 GMT"],
"Expect-Ct": ["max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct""],
"Expires": ["-1"],
"Pragma": ["no-cache"],
"Server": ["cloudflare"],
"Strict-Transport-Security": ["max-age=31536000; includeSubDomains"],
"Vary": ["Accept-Encoding"],
"X-Content-Type-Options": ["nosniff"],
"X-Request-Id": ["37b94c40-a4bf-4942-a0da-45dc5434d610"],
"X-Xss-Protection": ["1; mode=block"]
},
"Result": {

"errors": [{

"code": "bad_field",
"message": "Failed to attach public gateway of different zone to the subnet",
"target": {

"name": "public_gateway.id",
* [Subscriptions for jobs and job run limitations](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribing-eventssubscribing-events-jobrun-limits)
* [Eventing metadata](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribing-eventssubscribing-events-cloudevents)



* [Example HTTP headers for an IBM Cloud Object Storage event that is sent to an application](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribing-eventssubscribing-events-httpheaders-app)
* [Example environment variables for an IBM Cloud Object Storage event that is sent to a job](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribing-eventssubscribing-events-envvars-job)



* [What happens when I create a subscription?](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribing-eventssubscribing-events-what-happens)



[Working with the Periodic timer (cron) event producer](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribe-cronsubscribe-cron)



* [Subscribing to Periodic timer (cron) events for an application](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribe-croneventing-cron-existing-app)



* [Subscribing to Periodic timer (cron) events for an application from the console](https://cloud.ibm.com/docs/codeengine?topic=codeengine-subscribe-croneventing-cron-existing-app-ui)
"priority": 101,
"redirectUrl": "http://example.com"
},
"l7Rules": l7RuleArray1
}
]

client = SoftLayer.Client()
networkLBaaSL7PolicyService = client['SoftLayer_Network_LBaaS_L7Policy']

try:
result = networkLBaaSL7PolicyService.addL7Policies(listener_uuid, policies_rules)
pprint(result)
except SoftLayer.SoftLayerAPIError as e:
print("Unable to addL7Policies: %s, %s " % (e.faultCode, e.faultString))
Show more





 Update Layer 7 policy 

import SoftLayer
from pprint import pprint

 The ID of policy you want to update
networkLBaaSL7PolicyId = 11111111

 Update policy configuration by specifying the variable name and value , e.g. "<name>": "<value>"
policyConfiguration = {
"name": "<value>"
}

client = SoftLayer.Client()
networkLBaaSL7PolicyService = client['SoftLayer_Network_LBaaS_L7Policy']

try:
result = networkLBaaSL7PolicyService.editObject(policyConfiguration, id=networkLBaaSL7PolicyId)
pprint(result)
except SoftLayer.SoftLayerAPIError as e:
print("Unable to update the Layer 7 policy: %s, %s" % (e.faultCode, e.faultString))
Show more





 Add rules to a Layer 7 policy 

import SoftLayer
from pprint import pprint

 UUID of the Layer 7 policy
policyUuid = "set me"

 New rules to add
rules = [
{
"type": "FILE_TYPE",
Normal CosSourceReady 39s cossource-controller CosSource is ready

By default, the subscription cos create command first checks to see whether the destination application exists. If the destination check fails because the app name that you provided does not exist in your project, the subscription cos create command returns an error. If you want to create a subscription without first creating the application, use the --force option. By using the --force option, the command bypasses the destination check. Note that the Ready field of the subscription shows false until the destination app is created. Then, the subscription moves to a Ready: true state automatically.

After the subscription is created, but before the subscription cos create command reports any results, the subscription cos create command repeatedly polls the subscription for its status to verify its readiness. This continuous polling for status lasts for 15 seconds by default before it times out. If the subscription status returns as Ready:true, it reports success, otherwise it reports an error. You can change the amount of time that the subscription cos create command waits before it times out by using the --wait-timeout option. You can also bypass the status polling by setting the --no-wait option to false.

For more information about headers and body, see [HTTP headers and body information for events](https://cloud.ibm.com/docs/codeengine?topic=codeengine-eventing-cosevent-producersub-header-body-cos).

Note that subscriptions can affect how an application scales. For more information, see [Configuring application scaling](https://cloud.ibm.com/docs/codeengine?topic=codeengine-app-scale).





 Step 5: Testing your subscription 



1. Upload a .txt file to your bucket.
LoginWidget loginWidget = AppID.getInstance().getLoginWidget();
loginWidget.launchSignUp(this, new AuthorizationListener() {
@Override
public void onAuthorizationFailure (AuthorizationException exception) {
//Exception occurred
}

@Override
public void onAuthorizationCanceled () {
//Sign up canceled by the user
}

@Override
public void onAuthorizationSuccess (AccessToken accessToken, IdentityToken identityToken, RefreshToken refreshToken) {
if (accessToken != null && identityToken != null) {
//User authenticated
} else {
//email verification is required
}
}
});
Show more







 Forgot password 



1. Configure your Cloud Directory [settings](https://cloud.ibm.com/docs/appid?topic=appid-cloud-directorycd-settings) in the GUI. Allow users to manage their account from your app must be set to On.
2. In the Reset Password tab of the service dashboard, be sure that Forgot password email is set to On.
3. Add the following code to your app. When a user clicks "forgot password" in your application, the SDK calls the forgot_password API to send an email to the user that allows them to reset their password.

LoginWidget loginWidget = AppID.getInstance().getLoginWidget();
loginWidget.launchForgotPassword(this, new AuthorizationListener() {
@Override
public void onAuthorizationFailure (AuthorizationException exception) {
//Exception occurred
}

@Override
public void onAuthorizationCanceled () {
// Forogt password canceled by the user
}

@Override
_mask = "mask[members]"

try:
response = member_service.addLoadBalancerMembers(uuid, serverInstances, mask=_mask)
pprint(response)
except SoftLayer.SoftLayerAPIError as e:
print("Unable to add members: %s, %s" % (e.faultCode, e.faultString))
Show more





 Add a protocol 

import SoftLayer
from pprint import pprint

 Your load balancer UUID
uuid = 'set me'

 New protocols to add
protocolConfigurations = [
{
"backendPort": 1350,
"backendProtocol": "TCP",
"frontendPort": 1450,
"frontendProtocol": "TCP",
"loadBalancingMethod": "WEIGHTED_RR", ROUNDROBIN, LEASTCONNECTION, WEIGHTED_RR
"maxConn": 500,
"sessionType": "SOURCE_IP"
},
{
"backendPort": 1200,
"backendProtocol": "HTTP",
"frontendPort": 1150,
"frontendProtocol": "HTTP",
"loadBalancingMethod": "ROUNDROBIN", ROUNDROBIN, LEASTCONNECTION, WEIGHTED_RR
"maxConn": 1000,
"sessionType": "SOURCE_IP",
"serverTimeout": 70,
"clientTimeout": 70
}
]

 Create the api client
client = SoftLayer.Client()
listener_service = client['Network_LBaaS_Listener']

_mask = "mask[listeners]"

try:
response = listener_service.updateLoadBalancerProtocols(uuid, protocolConfigurations, mask=mask)
pprint(response)
except SoftLayer.SoftLayerAPIError as e:
--gitref-type <type_value> Enter the type of Git ref to use for this Satellite subscription. Valid values are branch, commit, tag, and release. 
 --gitref <gitref_value> Enter the Git ref to use for this Satellite subscription. 
 --path <path_value> Enter the path to the files in the remote repository to use for this Satellite subscription. 
 -q Do not show the message of the day or update reminders. 



Example output

Creating subscription...
OK
Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
4. Follow step 5 in [Creating Satellite configurations from the console](https://cloud.ibm.com/docs/satellite?topic=satellite-setup-clusters-satconfig) to review the rollout status of your Kubernetes resources.









 Updating your Satellite configuration 

To update your configuration, you can make updates on subscription level. The actions you need to take depends on what kind of updates you want to make.



* To deploy a new version of your application to the same cluster group, update the files in the GitHub or GitLab repository defined in your configuration and commit the changes.
* To change any properties of your source repository, you can edit the subscription and update the fields with new details.
* To associate multiple repositories with the same configuration, add a new source repository, or add new Git ref details for the same source repository, you can create new subscriptions. Click Create subscription and fill in the details of your new subscription. If you want to create a new subscription that only has a few details changed, you can use the Duplicate option to auto fill all the fields with properties of the existing subscription and modify the fields that you want to change.
* To delete a subscription, use the Remove option.





 Updating your subscription from the console 

Use the Satellite console to update your configuration.



1. Log in to the [Satellite Config UI](https://cloud.ibm.com/satellite/configuration) with your IBM Cloud credentials.
2.
console.log(JSON.stringify(res.result, null, 2));
})
.catch(err => {
console.warn(err)
});
2. Update the network zone by using the [ReplaceZone](https://cloud.ibm.com/apidocs/context-based-restrictions?code=goreplace-zone) method.



* Curl
* Java
* Python
* Go
* Node



curl -X PUT --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" --header "If-Match: {if_match}" --header "Content-Type: application/json" --data '{ "name": "an example of zone", "description": "this is an example of zone", "account_id": "12ab34cd56ef78ab90cd12ef34ab56cd", "addresses": [ { "type": "ipAddress", "value": "169.23.56.234" }, { "type": "ipRange", "value": "169.23.22.0-169.23.22.255" }, { "type": "vpc", "value": "crn:v1:bluemix:public:is:us-south:a/12ab34cd56ef78ab90cd12ef34ab56cd::vpc:r134-d98a1702-b39a-449a-86d4-ef8dbacf281e" } ] }' "{base_url}/v1/zones/{zone_id}"

AddressIPAddress addressModel = new AddressIPAddress.Builder()
.type("ipAddress")
.value("169.23.56.234")
.build();
ReplaceZoneOptions replaceZoneOptions = new ReplaceZoneOptions.Builder()
.zoneId("testString")
.ifMatch("testString")
Please see reasons for more details (KEY_CREATE_IMPORT_ACCESS_ERR)',
reasons='[KEY_CREATE_IMPORT_ACCESS_ERR:
KeyCreateImportAccess instance policy does not allow this action -
FOR_MORE_INFO_REFER: https://cloud.ibm.com/apidocs/key-protect]'

 step 2b - fails when using the the ibmcloud API
 because the instance policy prevents creating standard keys
$ curl -X POST "https://us-south.kms.cloud.ibm.com/api/v2/keys" -H "authorization: Bearer $ACCESS_TOKEN" -H "bluemix-instance: $KP_INSTANCE_ID" -H "content-type: application/vnd.ibm.kms.key+json" -d '{
"metadata": {
"collectionType": "application/vnd.ibm.kms.key+json",
"collectionTotal": 1
},
"resources": [
{
"type": "application/vnd.ibm.kms.key+json",
"name": "my-standard-key",
"description": "my-standard-key",
"extractable": true
}
]
}'
Show more





 JSON response from ibmcloud API 

{
"metadata": {
"collectionType": "application/vnd.ibm.kms.error+json",
"collectionTotal": 1
},
"resources": [
{
"errorMsg": "Conflict: Key could not be created: Please see reasons for more details (KEY_CREATE_IMPORT_ACCESS_ERR)",
"reasons":
{
"code": "KEY_CREATE_IMPORT_ACCESS_ERR",
"message": "KeyCreateImportAccess instance policy does not allow this action",
"status": 409,
18. Select Supersede an existing product.
![sup-super-prod.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-super-prod.png)
19. Select Weather Provider API Product 2.0.0 in the list of products presented. Click Next.
![sup-super-dialog-1.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-super-dialog-1.png)
20. Select Default plan. Click Supercede.
![sup-super-dialog-2.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-super-dialog-2.png) As a result of this replacement, the Weather Provider API Product 2.0.0 is deprecated, and the Weather Provider API Product 3.0.0 is published.
![sup-dash-prods-3.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-dash-prods-3.png)
21. Click Community >> Subscriptions.
Go to [IBM Cloud Support](https://cloud.ibm.com/unifiedsupport/supportcenter).





 BXNUI2087E 

Message: The app name is too long. This app name is limited to {0} characters.

Try again with a shorter name.





 BXNUI2088E 

Message: The action that you requested wasn't completed because the CSRF token is missing or invalid.

Log out, log back in, and try again. If you see this message again, go to the [IBM Cloud status page](https://cloud.ibm.com/status?selected=status) to check whether a service or component has an issue. If the problem continues, go to [IBM Cloud Support](https://cloud.ibm.com/unifiedsupport/supportcenter).





 BXNUI2089E 

Message: During an attempt to register a template at the URL "{0}", an error occurred. Error: "{1}".

Go to [IBM Cloud Support](https://cloud.ibm.com/unifiedsupport/supportcenter).





 BXNUI2090E 

Message: The attempt to register a template at the following URL failed: "{0}". The template's contents are malformed. Error: "{1}"

Go to [IBM Cloud Support](https://cloud.ibm.com/unifiedsupport/supportcenter).





 BXNUI2091E 

Message: The attempt to connect to the service broker URL, "{0}", failed because of an error: "{1}".

Go to [IBM Cloud Support](https://cloud.ibm.com/unifiedsupport/supportcenter).





 BXNUI2092E 

Message: An attempt to obtain the service broker catalog at the URL,"{0}", returned null.

Go to [IBM Cloud Support](https://cloud.ibm.com/unifiedsupport/supportcenter).





 BXNUI2093E
Select the profile that you scanned.
2. Select the Security and Compliance Center scan.
3. Click Add scan.
4. Click Next.









 Review requirements 

You must complete validation and any other requirements to publish to your account.





 Next steps 

After you onboard and validate your Operator bundle, you're ready to publish it to your account. From the Actions menu, select Publish to account. As a result, the Operator bundle is available only to users who have access to the Sample Operator Bundle private catalog in your account.
![sup-sand-dash.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-sand-dash.png)
15. Click Subscriptions.
![sup-comm-orgs.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-comm-orgs.png)
16. Note the application subscriptions to Weather Provider API Product 2.0.0. Click Products. ![sup-scriptions-200.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-scriptions-200.png)
17. Click the vertical ellipsis on the Weather Provider API Product 3.0.0 Staged line.
![sup-stage-prod-3.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-stage-prod-3.png)
18. Select Supersede an existing product.
![sup-super-prod.png](https://cloud.ibm.com/docs-content/v1/content/78bb71851d95d7580503eb9ba10cf3ae31490ade/apiconnect/tutorials/images/sup-super-prod.png)
19.