Fix REST API example for registering a new email address
Fix REST API example for registering a new email address

Since 398208835d7e3c1e9391c144b56f93b7945e0b7b setting a new email
address as preferred email address is only possible for administrators
or if the authentication type is 'DEVELOPMENT_BECOME_ANY_ACCOUNT'.
Update the description of 'preferred' in EmailInput and remove the
usage of 'preferred' from the example request since normal users can't
make use of it. Instead add 'pending_confirmation' to the example
response.

Change-Id: I6b2b59069baf0564a512ada8d446f28bd22cf7d2
Signed-off-by: Edwin Kempin <b444e279ad95fdef4fbdd82c813b624595df204a@sap.com>

pkdevbox/gerrit,renchaorevee/gerrit,gracefullife/gerrit,qtproject/qtqa-gerrit,joshuawilson/merrit,bpollack/gerrit,MerritCR/merrit,quyixia/gerrit,WANdisco/gerrit,Seinlin/gerrit,zommarin/gerrit,gcoders/gerrit,anminhsu/gerrit,Team-OctOS/host_gerrit,zommarin/gerrit,thesamet/gerrit,Seinlin/gerrit,dwhipstock/gerrit,MerritCR/merrit,thesamet/gerrit,gcoders/gerrit,hdost/gerrit,supriyantomaftuh/gerrit,jackminicloud/test,GerritCodeReview/gerrit,WANdisco/gerrit,anminhsu/gerrit,Distrotech/gerrit,Distrotech/gerrit,MerritCR/merrit,gcoders/gerrit,bootstraponline-archive/gerrit-mirror,TonyChai24/test,Distrotech/gerrit,gerrit-review/gerrit,qtproject/qtqa-gerrit,pkdevbox/gerrit,Team-OctOS/host_gerrit,dwhipstock/gerrit,TonyChai24/test,quyixia/gerrit,bpollack/gerrit,quyixia/gerrit,thinkernel/gerrit,thinkernel/gerrit,thesamet/gerrit,pkdevbox/gerrit,renchaorevee/gerrit,Saulis/gerrit,hdost/gerrit,hdost/gerrit,dwhipstock/gerrit,quyixia/gerrit,midnightradio/gerrit,hdost/gerrit,qtproject/qtqa-gerrit,gracefullife/gerrit,netroby/gerrit,midnightradio/gerrit,gracefullife/gerrit,renchaorevee/gerrit,gcoders/gerrit,gerrit-review/gerrit,hdost/gerrit,joshuawilson/merrit,gerrit-review/gerrit,supriyantomaftuh/gerrit,jackminicloud/test,jackminicloud/test,thinkernel/gerrit,dwhipstock/gerrit,Team-OctOS/host_gerrit,thinkernel/gerrit,jackminicloud/test,bpollack/gerrit,MerritCR/merrit,gcoders/gerrit,anminhsu/gerrit,supriyantomaftuh/gerrit,Seinlin/gerrit,joshuawilson/merrit,thinkernel/gerrit,MerritCR/merrit,anminhsu/gerrit,GerritCodeReview/gerrit,GerritCodeReview/gerrit,Seinlin/gerrit,dwhipstock/gerrit,gcoders/gerrit,qtproject/qtqa-gerrit,gerrit-review/gerrit,Seinlin/gerrit,gracefullife/gerrit,supriyantomaftuh/gerrit,midnightradio/gerrit,gracefullife/gerrit,Saulis/gerrit,WANdisco/gerrit,netroby/gerrit,TonyChai24/test,renchaorevee/gerrit,TonyChai24/test,Distrotech/gerrit,Seinlin/gerrit,renchaorevee/gerrit,Overruler/gerrit,WANdisco/gerrit,quyixia/gerrit,jackminicloud/test,pkdevbox/gerrit,netroby/gerrit,thesamet/gerrit,gerrit-review/gerrit,bpollack/gerrit,netroby/gerrit,joshuawilson/merrit,GerritCodeReview/gerrit,netroby/gerrit,MerritCR/merrit,Team-OctOS/host_gerrit,quyixia/gerrit,WANdisco/gerrit,supriyantomaftuh/gerrit,anminhsu/gerrit,MerritCR/merrit,TonyChai24/test,jackminicloud/test,renchaorevee/gerrit,thesamet/gerrit,bpollack/gerrit,gerrit-review/gerrit,midnightradio/gerrit,dwhipstock/gerrit,zommarin/gerrit,bpollack/gerrit,MerritCR/merrit,midnightradio/gerrit,gcoders/gerrit,Saulis/gerrit,jackminicloud/test,GerritCodeReview/gerrit,thesamet/gerrit,Overruler/gerrit,zommarin/gerrit,Seinlin/gerrit,bootstraponline-archive/gerrit-mirror,bootstraponline-archive/gerrit-mirror,thesamet/gerrit,Saulis/gerrit,Overruler/gerrit,Saulis/gerrit,netroby/gerrit,joshuawilson/merrit,qtproject/qtqa-gerrit,GerritCodeReview/gerrit,Distrotech/gerrit,pkdevbox/gerrit,joshuawilson/merrit,midnightradio/gerrit,hdost/gerrit,zommarin/gerrit,anminhsu/gerrit,thinkernel/gerrit,joshuawilson/merrit,supriyantomaftuh/gerrit,WANdisco/gerrit,WANdisco/gerrit,netroby/gerrit,pkdevbox/gerrit,GerritCodeReview/gerrit,bootstraponline-archive/gerrit-mirror,hdost/gerrit,GerritCodeReview/gerrit,Distrotech/gerrit,bootstraponline-archive/gerrit-mirror,joshuawilson/merrit,qtproject/qtqa-gerrit,anminhsu/gerrit,TonyChai24/test,Overruler/gerrit,Overruler/gerrit,bootstraponline-archive/gerrit-mirror,Overruler/gerrit,qtproject/qtqa-gerrit,Team-OctOS/host_gerrit,supriyantomaftuh/gerrit,quyixia/gerrit,dwhipstock/gerrit,Team-OctOS/host_gerrit,renchaorevee/gerrit,Team-OctOS/host_gerrit,thinkernel/gerrit,Saulis/gerrit,Distrotech/gerrit,pkdevbox/gerrit,gerrit-review/gerrit,TonyChai24/test